# SecretsManagerSecretOptions

Options for referencing a secret value from Secrets Manager.

- Source: [`core/lib/secret-value.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/core/lib/secret-value.ts#L249)

## Example

TypeScript:

```ts
new codebuild.BitBucketSourceCredentials(this, 'CodeBuildBitBucketCreds', {
  username: SecretValue.secretsManager('my-bitbucket-creds', { jsonField: 'username' }),
  password: SecretValue.secretsManager('my-bitbucket-creds', { jsonField: 'password' }),
});
```

Python:

```python
codebuild.BitBucketSourceCredentials(self, "CodeBuildBitBucketCreds",
    username=SecretValue.secrets_manager("my-bitbucket-creds", json_field="username"),
    password=SecretValue.secrets_manager("my-bitbucket-creds", json_field="password")
)
```

Java:

```java
BitBucketSourceCredentials.Builder.create(this, "CodeBuildBitBucketCreds")
        .username(SecretValue.secretsManager("my-bitbucket-creds", SecretsManagerSecretOptions.builder().jsonField("username").build()))
        .password(SecretValue.secretsManager("my-bitbucket-creds", SecretsManagerSecretOptions.builder().jsonField("password").build()))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
new BitBucketSourceCredentials(this, "CodeBuildBitBucketCreds", new BitBucketSourceCredentialsProps {
    Username = SecretValue.SecretsManager("my-bitbucket-creds", new SecretsManagerSecretOptions { JsonField = "username" }),
    Password = SecretValue.SecretsManager("my-bitbucket-creds", new SecretsManagerSecretOptions { JsonField = "password" })
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
codebuild.NewBitBucketSourceCredentials(this, jsii.String("CodeBuildBitBucketCreds"), &BitBucketSourceCredentialsProps{
	Username: awscdk.SecretValue_SecretsManager(jsii.String("my-bitbucket-creds"), &SecretsManagerSecretOptions{
		JsonField: jsii.String("username"),
	}),
	Password: awscdk.SecretValue_*SecretsManager(jsii.String("my-bitbucket-creds"), &SecretsManagerSecretOptions{
		JsonField: jsii.String("password"),
	}),
})
```

## Properties

- `jsonField`: string — The key of a JSON field to retrieve.

  **Default:** returns all the content stored in the Secrets Manager secret.

  This can only be used if the secret
  stores a JSON object.

- `versionId`: string = AWSCURRENT — Specifies the unique identifier of the version of the secret you want to use.

  Can specify at most one of `versionId` and `versionStage`.

- `versionStage`: string = AWSCURRENT — Specifies the secret version that you want to retrieve by the staging label attached to the version.

  Can specify at most one of `versionId` and `versionStage`.
