This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::InspectorV2::CodeSecurityIntegration
<a name="aws-resource-inspectorv2-codesecurityintegration"></a>

Creates a code security integration with a source code repository provider.

## Syntax
<a name="aws-resource-inspectorv2-codesecurityintegration-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-resource-inspectorv2-codesecurityintegration-syntax.json"></a>

```
{
  "Type" : "AWS::InspectorV2::CodeSecurityIntegration",
  "Properties" : {
      "[CreateIntegrationDetails](#cfn-inspectorv2-codesecurityintegration-createintegrationdetails)" : CreateDetails,
      "[Name](#cfn-inspectorv2-codesecurityintegration-name)" : String,
      "[Tags](#cfn-inspectorv2-codesecurityintegration-tags)" : {Key: Value, ...},
      "[Type](#cfn-inspectorv2-codesecurityintegration-type)" : String,
      "[UpdateIntegrationDetails](#cfn-inspectorv2-codesecurityintegration-updateintegrationdetails)" : UpdateDetails
    }
}
```

### YAML
<a name="aws-resource-inspectorv2-codesecurityintegration-syntax.yaml"></a>

```
Type: AWS::InspectorV2::CodeSecurityIntegration
Properties:
  [CreateIntegrationDetails](#cfn-inspectorv2-codesecurityintegration-createintegrationdetails): 
    CreateDetails
  [Name](#cfn-inspectorv2-codesecurityintegration-name): String
  [Tags](#cfn-inspectorv2-codesecurityintegration-tags): 
    Key: Value
  [Type](#cfn-inspectorv2-codesecurityintegration-type): String
  [UpdateIntegrationDetails](#cfn-inspectorv2-codesecurityintegration-updateintegrationdetails): 
    UpdateDetails
```

## Properties
<a name="aws-resource-inspectorv2-codesecurityintegration-properties"></a>

`CreateIntegrationDetails`  <a name="cfn-inspectorv2-codesecurityintegration-createintegrationdetails"></a>
Contains details required to create a code security integration with a specific repository provider.  
*Required*: No  
*Type*: [CreateDetails](aws-properties-inspectorv2-codesecurityintegration-createdetails.md)  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Name`  <a name="cfn-inspectorv2-codesecurityintegration-name"></a>
The name of the code security integration.  
*Required*: No  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9-_$:.]*$`  
*Minimum*: `1`  
*Maximum*: `60`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Tags`  <a name="cfn-inspectorv2-codesecurityintegration-tags"></a>
The tags to apply to the code security integration.  
*Required*: No  
*Type*: Object of String  
*Pattern*: `^.{2,127}$`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Type`  <a name="cfn-inspectorv2-codesecurityintegration-type"></a>
The type of repository provider for the integration.  
*Required*: No  
*Type*: String  
*Allowed values*: `GITLAB_SELF_MANAGED | GITHUB`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`UpdateIntegrationDetails`  <a name="cfn-inspectorv2-codesecurityintegration-updateintegrationdetails"></a>
The updated integration details specific to the repository provider type.  
*Required*: No  
*Type*: [UpdateDetails](aws-properties-inspectorv2-codesecurityintegration-updatedetails.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Return values
<a name="aws-resource-inspectorv2-codesecurityintegration-return-values"></a>

### Ref
<a name="aws-resource-inspectorv2-codesecurityintegration-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns the ARN of the code security integration.

For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).

 

### Fn::GetAtt
<a name="aws-resource-inspectorv2-codesecurityintegration-return-values-fn--getatt"></a>

The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-inspectorv2-codesecurityintegration-return-values-fn--getatt-fn--getatt"></a>

`Arn`  <a name="Arn-fn::getatt"></a>
The Amazon Resource Name (ARN) of the code security integration.

`AuthorizationUrl`  <a name="AuthorizationUrl-fn::getatt"></a>
The URL used to authorize the integration with the repository provider.

`CreatedAt`  <a name="CreatedAt-fn::getatt"></a>
The timestamp when the code security integration was created.

`LastUpdatedAt`  <a name="LastUpdatedAt-fn::getatt"></a>
The timestamp when the code security integration was last updated.

`Status`  <a name="Status-fn::getatt"></a>
The current status of the integration.

`StatusReason`  <a name="StatusReason-fn::getatt"></a>
The reason for the current status of the code security integration.

# AWS::InspectorV2::CodeSecurityIntegration CreateDetails
<a name="aws-properties-inspectorv2-codesecurityintegration-createdetails"></a>

Contains details required to create a code security integration with a specific repository provider.

## Syntax
<a name="aws-properties-inspectorv2-codesecurityintegration-createdetails-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-inspectorv2-codesecurityintegration-createdetails-syntax.json"></a>

```
{
  "[gitlabSelfManaged](#cfn-inspectorv2-codesecurityintegration-createdetails-gitlabselfmanaged)" : CreateGitLabSelfManagedIntegrationDetail
}
```

### YAML
<a name="aws-properties-inspectorv2-codesecurityintegration-createdetails-syntax.yaml"></a>

```
  [gitlabSelfManaged](#cfn-inspectorv2-codesecurityintegration-createdetails-gitlabselfmanaged): 
    CreateGitLabSelfManagedIntegrationDetail
```

## Properties
<a name="aws-properties-inspectorv2-codesecurityintegration-createdetails-properties"></a>

`gitlabSelfManaged`  <a name="cfn-inspectorv2-codesecurityintegration-createdetails-gitlabselfmanaged"></a>
Details specific to creating an integration with a self-managed GitLab instance.  
*Required*: Yes  
*Type*: [CreateGitLabSelfManagedIntegrationDetail](aws-properties-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail.md)  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

# AWS::InspectorV2::CodeSecurityIntegration CreateGitLabSelfManagedIntegrationDetail
<a name="aws-properties-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail"></a>

Contains details required to create an integration with a self-managed GitLab instance.

## Syntax
<a name="aws-properties-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-syntax.json"></a>

```
{
  "[accessToken](#cfn-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-accesstoken)" : String,
  "[instanceUrl](#cfn-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-instanceurl)" : String
}
```

### YAML
<a name="aws-properties-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-syntax.yaml"></a>

```
  [accessToken](#cfn-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-accesstoken): String
  [instanceUrl](#cfn-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-instanceurl): String
```

## Properties
<a name="aws-properties-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-properties"></a>

`accessToken`  <a name="cfn-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-accesstoken"></a>
The personal access token used to authenticate with the self-managed GitLab instance.  
*Required*: Yes  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`instanceUrl`  <a name="cfn-inspectorv2-codesecurityintegration-creategitlabselfmanagedintegrationdetail-instanceurl"></a>
The URL of the self-managed GitLab instance.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^https://[-a-zA-Z0-9()@:%_+.~#?&//=]{1,1024}$`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

# AWS::InspectorV2::CodeSecurityIntegration UpdateDetails
<a name="aws-properties-inspectorv2-codesecurityintegration-updatedetails"></a>

Contains details required to update a code security integration with a specific repository provider.

## Syntax
<a name="aws-properties-inspectorv2-codesecurityintegration-updatedetails-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-inspectorv2-codesecurityintegration-updatedetails-syntax.json"></a>

```
{
  "[github](#cfn-inspectorv2-codesecurityintegration-updatedetails-github)" : UpdateGitHubIntegrationDetail,
  "[gitlabSelfManaged](#cfn-inspectorv2-codesecurityintegration-updatedetails-gitlabselfmanaged)" : UpdateGitLabSelfManagedIntegrationDetail
}
```

### YAML
<a name="aws-properties-inspectorv2-codesecurityintegration-updatedetails-syntax.yaml"></a>

```
  [github](#cfn-inspectorv2-codesecurityintegration-updatedetails-github): 
    UpdateGitHubIntegrationDetail
  [gitlabSelfManaged](#cfn-inspectorv2-codesecurityintegration-updatedetails-gitlabselfmanaged): 
    UpdateGitLabSelfManagedIntegrationDetail
```

## Properties
<a name="aws-properties-inspectorv2-codesecurityintegration-updatedetails-properties"></a>

`github`  <a name="cfn-inspectorv2-codesecurityintegration-updatedetails-github"></a>
Details specific to updating an integration with GitHub.  
*Required*: No  
*Type*: [UpdateGitHubIntegrationDetail](aws-properties-inspectorv2-codesecurityintegration-updategithubintegrationdetail.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`gitlabSelfManaged`  <a name="cfn-inspectorv2-codesecurityintegration-updatedetails-gitlabselfmanaged"></a>
Details specific to updating an integration with a self-managed GitLab instance.  
*Required*: No  
*Type*: [UpdateGitLabSelfManagedIntegrationDetail](aws-properties-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::InspectorV2::CodeSecurityIntegration UpdateGitHubIntegrationDetail
<a name="aws-properties-inspectorv2-codesecurityintegration-updategithubintegrationdetail"></a>

Contains details required to update an integration with GitHub.

## Syntax
<a name="aws-properties-inspectorv2-codesecurityintegration-updategithubintegrationdetail-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-inspectorv2-codesecurityintegration-updategithubintegrationdetail-syntax.json"></a>

```
{
  "[code](#cfn-inspectorv2-codesecurityintegration-updategithubintegrationdetail-code)" : String,
  "[installationId](#cfn-inspectorv2-codesecurityintegration-updategithubintegrationdetail-installationid)" : String
}
```

### YAML
<a name="aws-properties-inspectorv2-codesecurityintegration-updategithubintegrationdetail-syntax.yaml"></a>

```
  [code](#cfn-inspectorv2-codesecurityintegration-updategithubintegrationdetail-code): String
  [installationId](#cfn-inspectorv2-codesecurityintegration-updategithubintegrationdetail-installationid): String
```

## Properties
<a name="aws-properties-inspectorv2-codesecurityintegration-updategithubintegrationdetail-properties"></a>

`code`  <a name="cfn-inspectorv2-codesecurityintegration-updategithubintegrationdetail-code"></a>
The authorization code received from GitHub to update the integration.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `1024`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`installationId`  <a name="cfn-inspectorv2-codesecurityintegration-updategithubintegrationdetail-installationid"></a>
The installation ID of the GitHub App associated with the integration.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `1024`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

# AWS::InspectorV2::CodeSecurityIntegration UpdateGitLabSelfManagedIntegrationDetail
<a name="aws-properties-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail"></a>

Contains details required to update an integration with a self-managed GitLab instance.

## Syntax
<a name="aws-properties-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail-syntax.json"></a>

```
{
  "[authCode](#cfn-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail-authcode)" : String
}
```

### YAML
<a name="aws-properties-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail-syntax.yaml"></a>

```
  [authCode](#cfn-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail-authcode): String
```

## Properties
<a name="aws-properties-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail-properties"></a>

`authCode`  <a name="cfn-inspectorv2-codesecurityintegration-updategitlabselfmanagedintegrationdetail-authcode"></a>
The authorization code received from the self-managed GitLab instance to update the integration.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `1024`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)