As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Recursos
<a name="resources"></a>

A API AWS Serverless Application Repository REST inclui os seguintes recursos.

**Topics**
+ [Applications](applications.md)
+ [Aplicativos ApplicationID](applications-applicationid.md)
+ [Aplicativos ApplicationID Changesets](applications-applicationid-changesets.md)
+ [Applications applicationId Dependencies](applications-applicationid-dependencies.md)
+ [Política de ApplicationID de aplicativos](applications-applicationid-policy.md)
+ [Applications applicationId Templates](applications-applicationid-templates.md)
+ [Applications applicationId Templates templateId](applications-applicationid-templates-templateid.md)
+ [Applications applicationId Unshare](applications-applicationid-unshare.md)
+ [Versões do ApplicationID de aplicativos](applications-applicationid-versions.md)
+ [Aplicativos: ApplicationID Versions SemanticVersion](applications-applicationid-versions-semanticversion.md)

# Applications
<a name="applications"></a>

## URI
<a name="applications-url"></a>

`/applications`

## Métodos HTTP
<a name="applications-http-methods"></a>

### GET
<a name="applicationsget"></a>

**ID da operação:** `ListApplications`

Lista os aplicativos de propriedade do solicitante.


**Parâmetros de consulta**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| maxItems | String | Falso | O número total de itens a serem devolvidos. | 
| nextToken | String | Falso | Um token para especificar onde iniciar a paginação. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | ApplicationPage | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### POST
<a name="applicationspost"></a>

**ID da operação:** `CreateApplication`

Cria um aplicativo, incluindo opcionalmente um arquivo AWS SAM para criar a primeira versão do aplicativo na mesma chamada.


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 201 | Application | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 409 | ConflictException | O recurso já existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applicationsoptions"></a>


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-schemas"></a>

### Corpos da solicitação
<a name="applications-request-examples"></a>

#### Esquema POST
<a name="applications-request-body-post-example"></a>

```
{
  "name": "string",
  "description": "string",
  "author": "string",
  "spdxLicenseId": "string",
  "licenseBody": "string",
  "licenseUrl": "string",
  "readmeBody": "string",
  "readmeUrl": "string",
  "labels": [
    "string"
  ],
  "homePageUrl": "string",
  "semanticVersion": "string",
  "templateBody": "string",
  "templateUrl": "string",
  "sourceCodeUrl": "string",
  "sourceCodeArchiveUrl": "string"
}
```

### Corpos da resposta
<a name="applications-response-examples"></a>

#### Esquema ApplicationPage
<a name="applications-response-body-applicationpage-example"></a>

```
{
  "applications": [
    {
      "applicationId": "string",
      "name": "string",
      "description": "string",
      "author": "string",
      "spdxLicenseId": "string",
      "labels": [
        "string"
      ],
      "creationTime": "string",
      "homePageUrl": "string"
    }
  ],
  "nextToken": "string"
}
```

#### Esquema Application
<a name="applications-response-body-application-example"></a>

```
{
  "applicationId": "string",
  "name": "string",
  "description": "string",
  "author": "string",
  "isVerifiedAuthor": boolean,
  "verifiedAuthorUrl": "string",
  "spdxLicenseId": "string",
  "licenseUrl": "string",
  "readmeUrl": "string",
  "labels": [
    "string"
  ],
  "creationTime": "string",
  "homePageUrl": "string",
  "version": {
    "applicationId": "string",
    "semanticVersion": "string",
    "sourceCodeUrl": "string",
    "sourceCodeArchiveUrl": "string",
    "templateUrl": "string",
    "creationTime": "string",
    "parameterDefinitions": [
      {
        "name": "string",
        "defaultValue": "string",
        "description": "string",
        "type": "string",
        "noEcho": boolean,
        "allowedPattern": "string",
        "constraintDescription": "string",
        "minValue": integer,
        "maxValue": integer,
        "minLength": integer,
        "maxLength": integer,
        "allowedValues": [
          "string"
        ],
        "referencedByResources": [
          "string"
        ]
      }
    ],
    "requiredCapabilities": [
      enum
    ],
    "resourcesSupported": boolean
  }
}
```

#### Esquema BadRequestException
<a name="applications-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema NotFoundException
<a name="applications-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ConflictException
<a name="applications-response-body-conflictexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-properties"></a>

### Application
<a name="applications-model-application"></a>

Detalhes sobre o aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| author | string | Verdadeiro | O nome do autor que publica o aplicativo.Comprimento mínimo = 1. Tamanho máximo = 127.Padrão “^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1”; | 
| creationTime | string | Falso | A data e a hora em que esse recurso foi criado. | 
| description | string | Verdadeiro | A descrição do aplicativo.Comprimento mínimo = 1. Comprimento máximo = 256 | 
| homePageUrl | string | Falso | Uma URL com mais informações sobre o aplicativo, por exemplo, a localização do seu GitHub repositório para o aplicativo. | 
| isVerifiedAuthor | booleano | Falso | Especifica se o autor desse aplicativo foi verificado. Isso significa que AWS fez uma análise de boa fé, como prestador de serviços razoável e prudente, das informações fornecidas pelo solicitante e confirmou que a identidade do solicitante é a reivindicada. | 
| labels | Matriz do tipo string | Falso | Rótulos para melhorar a descoberta de aplicativos nos resultados de pesquisa.Comprimento mínimo = 1. Tamanho máximo = 127. Número máximo de etiquetas: 10Padrão: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | 
| licenseUrl | string | Falso | Um link para um arquivo de licença do aplicativo que corresponde ao valor SPDXLicenseID do seu aplicativo.Tamanho máximo 5 MB | 
| name | string | Verdadeiro | O nome da aplicação.Comprimento mínimo = 1. Comprimento máximo = 140Padrão: "[a-zA-Z0-9\$1\$1-]\$1"; | 
| readmeUrl | string | Falso | Um link para o arquivo readme na linguagem Markdown que contém uma descrição mais detalhada do aplicativo e de como ele funciona.Tamanho máximo 5 MB | 
| spdxLicenseId | string | Falso | Um identificador válido de https://spdx.org/licenses/. | 
| verifiedAuthorUrl | string | Falso | O URL do perfil público de um autor verificado. Esse URL foi enviado pelo autor. | 
| version | [Versão](#applications-model-version) | Falso | Informações sobre a versão do aplicativo. | 

### ApplicationPage
<a name="applications-model-applicationpage"></a>

Uma lista dos detalhes do aplicativo.


| Propriedade | Tipo | Obrigatório | Description | 
| --- |--- |--- |--- |
| applications | Matriz do tipo [ApplicationSummary](#applications-model-applicationsummary) | Verdadeiro | Uma série de resumos de aplicativos. | 
| nextToken | string | Falso | O token para recuperação do próximo conjunto de resultados. | 

### ApplicationSummary
<a name="applications-model-applicationsummary"></a>

Resumo dos detalhes sobre o aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| author | string | Verdadeiro | O nome do autor que publica o aplicativo.Comprimento mínimo = 1. Tamanho máximo = 127.Padrão “^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1”; | 
| creationTime | string | Falso | A data e a hora em que esse recurso foi criado. | 
| description | string | Verdadeiro | A descrição do aplicativo.Comprimento mínimo = 1. Comprimento máximo = 256 | 
| homePageUrl | string | Falso | Uma URL com mais informações sobre o aplicativo, por exemplo, a localização do seu GitHub repositório para o aplicativo. | 
| labels | Matriz do tipo string | Falso | Rótulos para melhorar a descoberta de aplicativos nos resultados de pesquisa.Comprimento mínimo = 1. Tamanho máximo = 127. Número máximo de etiquetas: 10Padrão: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | 
| name | string | Verdadeiro | O nome da aplicação.Comprimento mínimo = 1. Comprimento máximo = 140Padrão: "[a-zA-Z0-9\$1\$1-]\$1"; | 
| spdxLicenseId | string | Falso | Um identificador válido de [https://spdx.org/licenses/](https://spdx.org/licenses/). | 

### BadRequestException
<a name="applications-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### Capability
<a name="applications-model-capability"></a>

Valores que devem ser especificados para implantar alguns aplicativos.
+ `CAPABILITY_IAM`
+ `CAPABILITY_NAMED_IAM`
+ `CAPABILITY_AUTO_EXPAND`
+ `CAPABILITY_RESOURCE_POLICY`

### ConflictException
<a name="applications-model-conflictexception"></a>

O recurso já existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 409 | 
| message | string | Falso | O recurso já existe. | 

### CreateApplicationInput
<a name="applications-model-createapplicationinput"></a>

Crie uma solicitação de aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| author | string | Verdadeiro | O nome do autor que publica o aplicativo.Comprimento mínimo = 1. Tamanho máximo = 127.Padrão “^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1”; | 
| description | string | Verdadeiro | A descrição do aplicativo.Comprimento mínimo = 1. Comprimento máximo = 256 | 
| homePageUrl | string | Falso | Uma URL com mais informações sobre o aplicativo, por exemplo, a localização do seu GitHub repositório para o aplicativo. | 
| labels | Matriz do tipo string | Falso | Rótulos para melhorar a descoberta de aplicativos nos resultados de pesquisa.Comprimento mínimo = 1. Tamanho máximo = 127. Número máximo de etiquetas: 10Padrão: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | 
| licenseBody | string | Falso | Um arquivo de texto local que contém a licença do aplicativo que corresponde ao valor SPDXLicenseID do seu aplicativo. O arquivo tem o formato`file://<path>/<filename>`.Tamanho máximo 5 MBVocê pode especificar somente um dos `licenseBody` e`licenseUrl`; caso contrário, ocorrerá um erro. | 
| licenseUrl | string | Falso | Um link para o objeto S3 que contém a licença do aplicativo que corresponde ao valor SPDXLicenseID do seu aplicativo.Tamanho máximo 5 MBVocê pode especificar somente um dos `licenseBody` e`licenseUrl`; caso contrário, ocorrerá um erro. | 
| name | string | Verdadeiro | O nome do aplicativo que você deseja publicar.Comprimento mínimo = 1. Comprimento máximo = 140Padrão: "[a-zA-Z0-9\$1\$1-]\$1"; | 
| readmeBody | string | Falso | Um arquivo readme de texto local na linguagem Markdown que contém uma descrição mais detalhada do aplicativo e de como ele funciona. O arquivo tem o formato`file://<path>/<filename>`.Tamanho máximo 5 MBVocê pode especificar somente um dos `readmeBody` e`readmeUrl`; caso contrário, ocorrerá um erro. | 
| readmeUrl | string | Falso | Um link para o objeto S3 na linguagem Markdown que contém uma descrição mais detalhada do aplicativo e de como ele funciona.Tamanho máximo 5 MBVocê pode especificar somente um dos `readmeBody` e`readmeUrl`; caso contrário, ocorrerá um erro. | 
| semanticVersion | string | Falso | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| sourceCodeArchiveUrl | string | Falso | Um link para o objeto S3 que contém o arquivo ZIP do código-fonte dessa versão do seu aplicativo.Tamanho máximo 50 MB | 
| sourceCodeUrl | string | Falso | Um link para um repositório público para o código-fonte do seu aplicativo, por exemplo, o URL de um GitHub commit específico. | 
| spdxLicenseId | string | Falso | Um identificador válido de [https://spdx.org/licenses/](https://spdx.org/licenses/). | 
| templateBody | string | Falso | O arquivo de AWS SAM modelo empacotado bruto local do seu aplicativo. O arquivo tem o formato`file://<path>/<filename>`.Você pode especificar somente um dos `templateBody` e`templateUrl`; caso contrário, ocorrerá um erro. | 
| templateUrl | string | Falso | Um link para o objeto S3 contendo o AWS SAM modelo empacotado do seu aplicativo.Você pode especificar somente um dos `templateBody` e`templateUrl`; caso contrário, ocorrerá um erro. | 

### ForbiddenException
<a name="applications-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### NotFoundException
<a name="applications-model-notfoundexception"></a>

O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 404 | 
| message | string | Falso | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 

### ParameterDefinition
<a name="applications-model-parameterdefinition"></a>

Parâmetros suportados pelo aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| allowedPattern | string | Falso | Uma expressão regular que representa os padrões a serem permitidos para tipos `String`. | 
| allowedValues | Matriz do tipo string | Falso | Uma matriz que contém a lista de valores permitidos para o parâmetro. | 
| constraintDescription | string | Falso | Uma sequência que explica uma restrição quando a restrição é violada. Por exemplo, sem uma descrição da restrição, um parâmetro que tem um padrão permitido de `[A-Za-z0-9]+` exibe a seguinte mensagem de erro quando o usuário especifica um valor inválido: `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` Ao adicionar uma descrição de restrição, como “deve conter somente letras maiúsculas e minúsculas e números”, você pode exibir a seguinte mensagem de erro personalizada: `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.`  | 
| defaultValue | string | Falso | Um valor do tipo apropriado para o modelo a ser usado se nenhum valor for especificado quando uma pilha é criada. Se definir restrições para o parâmetro, você deverá especificar um valor que esteja de acordo com essas restrições. | 
| description | string | Falso | Uma sequência de até 4.000 caracteres que descreve o parâmetro. | 
| maxLength | integer | Falso | Um valor inteiro que determina o maior número de caracteres que você deseja permitir para `String` tipos. | 
| maxValue | integer | Falso | Um valor numérico que determina o maior valor numérico que você deseja permitir para `Number` tipos. | 
| minLength | integer | Falso | Um valor inteiro que determina o menor número de caracteres que você deseja permitir para `String` tipos. | 
| minValue | integer | Falso | Um valor numérico que determina o menor valor numérico que você deseja permitir para `Number` tipos. | 
| name | string | Verdadeiro | O nome do parâmetro. | 
| noEcho | booleano | Falso | Se o valor do parâmetro deve ser mascarado sempre que alguém fizer uma chamada que descreva a pilha. Se você definir o valor como verdadeiro, o valor do parâmetro será mascarado com asteriscos (\$1\$1\$1\$1\$1). | 
| referencedByResources | Matriz do tipo string | Verdadeiro | Uma lista de AWS SAM recursos que usam esse parâmetro. | 
| type | string | Falso | O tipo do parâmetro.Valores válidos: `String \| Number \| List<Number> \| CommaDelimitedList`  `String`: Uma sequência de caracteres literal.Por exemplo, os usuários podem especificar`"MyUserName"`. `Number`: Um número inteiro ou flutuante. CloudFormation valida o valor do parâmetro como um número. No entanto, quando você usa o parâmetro em outro lugar em seu modelo (por exemplo, usando a função `Ref` intrínseca), o valor do parâmetro se torna uma string.Por exemplo, os usuários podem especificar`"8888"`. `List<Number>`: uma matriz de números inteiros ou flutuantes separados por vírgulas. CloudFormation valida o valor do parâmetro como números. No entanto, quando você usa o parâmetro em outro lugar do seu modelo (por exemplo, usando a função `Ref` intrínseca), o valor do parâmetro se torna uma lista de cadeias de caracteres.Por exemplo, os usuários podem especificar “80,20" e, em seguida, resultar em`Ref`. `["80","20"]` `CommaDelimitedList`: uma matriz de cadeias de caracteres literais separadas por vírgulas. O total de sequências deve ser um número a mais que o número total de vírgulas. Além disso, cada sequência de membros é cortada com espaço.Por exemplo, os usuários podem especificar “test, dev, prod” e, em seguida, `Ref` resultar em`["test","dev","prod"]`. | 

### TooManyRequestsException
<a name="applications-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

### Version
<a name="applications-model-version"></a>

Detalhes da versão do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| creationTime | string | Verdadeiro | A data e a hora em que esse recurso foi criado. | 
| parameterDefinitions | Matriz do tipo [ParameterDefinition](#applications-model-parameterdefinition) | Verdadeiro | Uma matriz de tipos de parâmetros suportados pelo aplicativo. | 
| requiredCapabilities | Matriz do tipo [Capability](#applications-model-capability) | Verdadeiro | Uma lista de valores que você deve especificar antes de poder implantar determinados aplicativos. Alguns aplicativos podem incluir recursos que podem afetar as permissões em sua AWS conta, por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro.Os únicos valores válidos são `CAPABILITY_IAM` `CAPABILITY_NAMED_IAM``CAPABILITY_RESOURCE_POLICY`,, `CAPABILITY_AUTO_EXPAND` e.Os recursos a seguir exigem que você especifique `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`: [AWS::IAM::Group[AWS::IAM::InstanceProfile[AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html),, [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)e. Se o aplicativo contiver recursos do IAM, você poderá especificar `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`. Se o aplicativo contém recursos do IAM com nomes personalizados, você deverá especificar `CAPABILITY_NAMED_IAM`.Os recursos a seguir exigem que você especifique`CAPABILITY_RESOURCE_POLICY`: [AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS: :iam:policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html),, [AWS::ApplicationAutoScaling::ScalingPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), e. [AWS::S3::BucketPolicy[AWS::SQS::QueuePolicy[AWS::SNS::TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)Os aplicativos que contêm um ou mais aplicativos aninhados exigem que você especifique `CAPABILITY_AUTO_EXPAND`.Se seu modelo de aplicativo contiver algum dos recursos acima, recomendamos que você revise todas as permissões associadas ao aplicativo antes da implantação. Se você não especificar esse parâmetro para um aplicativo que requer recursos, a chamada falhará. | 
| resourcesSupported | booliano | Verdadeiro | Se todos os AWS recursos contidos nesse aplicativo são suportados na região em que ele está sendo recuperado. | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| sourceCodeArchiveUrl | string | Falso | Um link para o objeto S3 que contém o arquivo ZIP do código-fonte dessa versão do seu aplicativo.Tamanho máximo 50 MB | 
| sourceCodeUrl | string | Falso | Um link para um repositório público para o código-fonte do seu aplicativo, por exemplo, o URL de um GitHub commit específico. | 
| templateUrl | string | Verdadeiro | Um link para o AWS SAM modelo empacotado do seu aplicativo. | 

## Consulte também
<a name="applications-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### ListApplications
<a name="ListApplications-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplications)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplications)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplications)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplications)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplications)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplications)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplications)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplications)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/ListApplications)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplications)

### CreateApplication
<a name="CreateApplication-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplication)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplication)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplication)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplication)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplication)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplication)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplication)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplication)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/CreateApplication)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplication)

# Aplicativos ApplicationID
<a name="applications-applicationid"></a>

## URI
<a name="applications-applicationid-url"></a>

`/applications/applicationId`

## Métodos HTTP
<a name="applications-applicationid-http-methods"></a>

### GET
<a name="applications-applicationidget"></a>

**ID da operação:** `GetApplication`

Obtém o aplicativo especificado.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Parâmetros de consulta**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| semanticVersion | String | Falso | A versão semântica do aplicativo a ser obtida. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Application | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### DELETE
<a name="applications-applicationiddelete"></a>

**ID da operação:** `DeleteApplication`

Exclui o aplicativo especificado.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 204 | Nenhum | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 409 | ConflictException | O recurso já existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationidoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

### PATCH
<a name="applications-applicationidpatch"></a>

**ID da operação:** `UpdateApplication`

Atualiza o aplicativo especificado.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Application | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 409 | ConflictException | O recurso já existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

## Esquemas
<a name="applications-applicationid-schemas"></a>

### Corpos da solicitação
<a name="applications-applicationid-request-examples"></a>

#### Esquema PATCH
<a name="applications-applicationid-request-body-patch-example"></a>

```
{
  "description": "string",
  "author": "string",
  "readmeBody": "string",
  "readmeUrl": "string",
  "labels": [
    "string"
  ],
  "homePageUrl": "string"
}
```

### Corpos da resposta
<a name="applications-applicationid-response-examples"></a>

#### Esquema Application
<a name="applications-applicationid-response-body-application-example"></a>

```
{
  "applicationId": "string",
  "name": "string",
  "description": "string",
  "author": "string",
  "isVerifiedAuthor": boolean,
  "verifiedAuthorUrl": "string",
  "spdxLicenseId": "string",
  "licenseUrl": "string",
  "readmeUrl": "string",
  "labels": [
    "string"
  ],
  "creationTime": "string",
  "homePageUrl": "string",
  "version": {
    "applicationId": "string",
    "semanticVersion": "string",
    "sourceCodeUrl": "string",
    "sourceCodeArchiveUrl": "string",
    "templateUrl": "string",
    "creationTime": "string",
    "parameterDefinitions": [
      {
        "name": "string",
        "defaultValue": "string",
        "description": "string",
        "type": "string",
        "noEcho": boolean,
        "allowedPattern": "string",
        "constraintDescription": "string",
        "minValue": integer,
        "maxValue": integer,
        "minLength": integer,
        "maxLength": integer,
        "allowedValues": [
          "string"
        ],
        "referencedByResources": [
          "string"
        ]
      }
    ],
    "requiredCapabilities": [
      enum
    ],
    "resourcesSupported": boolean
  }
}
```

#### Esquema BadRequestException
<a name="applications-applicationid-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema NotFoundException
<a name="applications-applicationid-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ConflictException
<a name="applications-applicationid-response-body-conflictexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-properties"></a>

### Application
<a name="applications-applicationid-model-application"></a>

Detalhes sobre o aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| author | string | Verdadeiro | O nome do autor que publica o aplicativo.Comprimento mínimo = 1. Tamanho máximo = 127.Padrão “^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1”; | 
| creationTime | string | Falso | A data e a hora em que esse recurso foi criado. | 
| description | string | Verdadeiro | A descrição do aplicativo.Comprimento mínimo = 1. Comprimento máximo = 256 | 
| homePageUrl | string | Falso | Uma URL com mais informações sobre o aplicativo, por exemplo, a localização do seu GitHub repositório para o aplicativo. | 
| isVerifiedAuthor | booleano | Falso | Especifica se o autor desse aplicativo foi verificado. Isso significa que AWS fez uma análise de boa fé, como prestador de serviços razoável e prudente, das informações fornecidas pelo solicitante e confirmou que a identidade do solicitante é a reivindicada. | 
| labels | Matriz do tipo string | Falso | Rótulos para melhorar a descoberta de aplicativos nos resultados de pesquisa.Comprimento mínimo = 1. Tamanho máximo = 127. Número máximo de etiquetas: 10Padrão: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | 
| licenseUrl | string | Falso | Um link para um arquivo de licença do aplicativo que corresponde ao valor SPDXLicenseID do seu aplicativo.Tamanho máximo 5 MB | 
| name | string | Verdadeiro | O nome da aplicação.Comprimento mínimo = 1. Comprimento máximo = 140Padrão: "[a-zA-Z0-9\$1\$1-]\$1"; | 
| readmeUrl | string | Falso | Um link para o arquivo readme na linguagem Markdown que contém uma descrição mais detalhada do aplicativo e de como ele funciona.Tamanho máximo 5 MB | 
| spdxLicenseId | string | Falso | Um identificador válido de https://spdx.org/licenses/. | 
| verifiedAuthorUrl | string | Falso | O URL do perfil público de um autor verificado. Esse URL foi enviado pelo autor. | 
| version | [Versão](#applications-applicationid-model-version) | Falso | Informações sobre a versão do aplicativo. | 

### BadRequestException
<a name="applications-applicationid-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### Capability
<a name="applications-applicationid-model-capability"></a>

Valores que devem ser especificados para implantar alguns aplicativos.
+ `CAPABILITY_IAM`
+ `CAPABILITY_NAMED_IAM`
+ `CAPABILITY_AUTO_EXPAND`
+ `CAPABILITY_RESOURCE_POLICY`

### ConflictException
<a name="applications-applicationid-model-conflictexception"></a>

O recurso já existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 409 | 
| message | string | Falso | O recurso já existe. | 

### ForbiddenException
<a name="applications-applicationid-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### NotFoundException
<a name="applications-applicationid-model-notfoundexception"></a>

O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 404 | 
| message | string | Falso | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 

### ParameterDefinition
<a name="applications-applicationid-model-parameterdefinition"></a>

Parâmetros suportados pelo aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| allowedPattern | string | Falso | Uma expressão regular que representa os padrões a serem permitidos para tipos `String`. | 
| allowedValues | Matriz do tipo string | Falso | Uma matriz que contém a lista de valores permitidos para o parâmetro. | 
| constraintDescription | string | Falso | Uma sequência que explica uma restrição quando a restrição é violada. Por exemplo, sem uma descrição da restrição, um parâmetro que tem um padrão permitido de `[A-Za-z0-9]+` exibe a seguinte mensagem de erro quando o usuário especifica um valor inválido: `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` Ao adicionar uma descrição de restrição, como “deve conter somente letras maiúsculas e minúsculas e números”, você pode exibir a seguinte mensagem de erro personalizada: `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.`  | 
| defaultValue | string | Falso | Um valor do tipo apropriado para o modelo a ser usado se nenhum valor for especificado quando uma pilha é criada. Se definir restrições para o parâmetro, você deverá especificar um valor que esteja de acordo com essas restrições. | 
| description | string | Falso | Uma sequência de até 4.000 caracteres que descreve o parâmetro. | 
| maxLength | integer | Falso | Um valor inteiro que determina o maior número de caracteres que você deseja permitir para `String` tipos. | 
| maxValue | integer | Falso | Um valor numérico que determina o maior valor numérico que você deseja permitir para `Number` tipos. | 
| minLength | integer | Falso | Um valor inteiro que determina o menor número de caracteres que você deseja permitir para `String` tipos. | 
| minValue | integer | Falso | Um valor numérico que determina o menor valor numérico que você deseja permitir para `Number` tipos. | 
| name | string | Verdadeiro | O nome do parâmetro. | 
| noEcho | booleano | Falso | Se o valor do parâmetro deve ser mascarado sempre que alguém fizer uma chamada que descreva a pilha. Se você definir o valor como verdadeiro, o valor do parâmetro será mascarado com asteriscos (\$1\$1\$1\$1\$1). | 
| referencedByResources | Matriz do tipo string | Verdadeiro | Uma lista de AWS SAM recursos que usam esse parâmetro. | 
| type | string | Falso | O tipo do parâmetro.Valores válidos: `String \| Number \| List<Number> \| CommaDelimitedList`  `String`: Uma sequência de caracteres literal.Por exemplo, os usuários podem especificar`"MyUserName"`. `Number`: Um número inteiro ou flutuante. CloudFormation valida o valor do parâmetro como um número. No entanto, quando você usa o parâmetro em outro lugar em seu modelo (por exemplo, usando a função `Ref` intrínseca), o valor do parâmetro se torna uma string.Por exemplo, os usuários podem especificar`"8888"`. `List<Number>`: uma matriz de números inteiros ou flutuantes separados por vírgulas. CloudFormation valida o valor do parâmetro como números. No entanto, quando você usa o parâmetro em outro lugar do seu modelo (por exemplo, usando a função `Ref` intrínseca), o valor do parâmetro se torna uma lista de cadeias de caracteres.Por exemplo, os usuários podem especificar “80,20" e, em seguida, resultar em`Ref`. `["80","20"]` `CommaDelimitedList`: uma matriz de cadeias de caracteres literais separadas por vírgulas. O total de sequências deve ser um número a mais que o número total de vírgulas. Além disso, cada sequência de membros é cortada com espaço.Por exemplo, os usuários podem especificar “test, dev, prod” e, em seguida, `Ref` resultar em`["test","dev","prod"]`. | 

### TooManyRequestsException
<a name="applications-applicationid-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

### UpdateApplicationInput
<a name="applications-applicationid-model-updateapplicationinput"></a>

Atualize a solicitação do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| author | string | Falso | O nome do autor que publica o aplicativo.Comprimento mínimo = 1. Tamanho máximo = 127.Padrão “^ [a-z0-9] (([a-z0-9] \$1- (?\$1 -)) \$1 [a-z0-9])? \$1”; | 
| description | string | Falso | A descrição do aplicativo.Comprimento mínimo = 1. Comprimento máximo = 256 | 
| homePageUrl | string | Falso | Uma URL com mais informações sobre o aplicativo, por exemplo, a localização do seu GitHub repositório para o aplicativo. | 
| labels | Matriz do tipo string | Falso | Rótulos para melhorar a descoberta de aplicativos nos resultados de pesquisa.Comprimento mínimo = 1. Tamanho máximo = 127. Número máximo de etiquetas: 10Padrão: "^[a-zA-Z0-9\$1\$1\$1-\$1:\$1\$1/@]\$1\$1"; | 
| readmeBody | string | Falso | Um arquivo readme de texto na linguagem Markdown que contém uma descrição mais detalhada do aplicativo e de como ele funciona.Tamanho máximo 5 MB | 
| readmeUrl | string | Falso | Um link para o arquivo readme na linguagem Markdown que contém uma descrição mais detalhada do aplicativo e de como ele funciona.Tamanho máximo 5 MB | 

### Version
<a name="applications-applicationid-model-version"></a>

Detalhes da versão do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| creationTime | string | Verdadeiro | A data e a hora em que esse recurso foi criado. | 
| parameterDefinitions | Matriz do tipo [ParameterDefinition](#applications-applicationid-model-parameterdefinition) | Verdadeiro | Uma matriz de tipos de parâmetros suportados pelo aplicativo. | 
| requiredCapabilities | Matriz do tipo [Capability](#applications-applicationid-model-capability) | Verdadeiro | Uma lista de valores que você deve especificar antes de poder implantar determinados aplicativos. Alguns aplicativos podem incluir recursos que podem afetar as permissões em sua AWS conta, por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro.Os únicos valores válidos são `CAPABILITY_IAM` `CAPABILITY_NAMED_IAM``CAPABILITY_RESOURCE_POLICY`,, `CAPABILITY_AUTO_EXPAND` e.Os recursos a seguir exigem que você especifique `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`: [AWS::IAM::Group[AWS::IAM::InstanceProfile[AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html),, [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)e. Se o aplicativo contiver recursos do IAM, você poderá especificar `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`. Se o aplicativo contém recursos do IAM com nomes personalizados, você deverá especificar `CAPABILITY_NAMED_IAM`.Os recursos a seguir exigem que você especifique`CAPABILITY_RESOURCE_POLICY`: [AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS: :iam:policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html),, [AWS::ApplicationAutoScaling::ScalingPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), e. [AWS::S3::BucketPolicy[AWS::SQS::QueuePolicy[AWS::SNS::TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)Os aplicativos que contêm um ou mais aplicativos aninhados exigem que você especifique `CAPABILITY_AUTO_EXPAND`.Se seu modelo de aplicativo contiver algum dos recursos acima, recomendamos que você revise todas as permissões associadas ao aplicativo antes da implantação. Se você não especificar esse parâmetro para um aplicativo que requer recursos, a chamada falhará. | 
| resourcesSupported | booliano | Verdadeiro | Se todos os AWS recursos contidos nesse aplicativo são suportados na região em que ele está sendo recuperado. | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| sourceCodeArchiveUrl | string | Falso | Um link para o objeto S3 que contém o arquivo ZIP do código-fonte dessa versão do seu aplicativo.Tamanho máximo 50 MB | 
| sourceCodeUrl | string | Falso | Um link para um repositório público para o código-fonte do seu aplicativo, por exemplo, o URL de um GitHub commit específico. | 
| templateUrl | string | Verdadeiro | Um link para o AWS SAM modelo empacotado do seu aplicativo. | 

## Consulte também
<a name="applications-applicationid-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### GetApplication
<a name="GetApplication-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/GetApplication)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/GetApplication)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/GetApplication)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/GetApplication)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/GetApplication)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/GetApplication)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/GetApplication)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/GetApplication)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/GetApplication)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/GetApplication)

### DeleteApplication
<a name="DeleteApplication-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/DeleteApplication)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/DeleteApplication)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/DeleteApplication)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/DeleteApplication)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/DeleteApplication)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/DeleteApplication)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/DeleteApplication)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/DeleteApplication)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/DeleteApplication)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/DeleteApplication)

### UpdateApplication
<a name="UpdateApplication-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/UpdateApplication)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/UpdateApplication)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/UpdateApplication)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/UpdateApplication)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/UpdateApplication)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/UpdateApplication)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/UpdateApplication)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/UpdateApplication)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/UpdateApplication)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/UpdateApplication)

# Aplicativos ApplicationID Changesets
<a name="applications-applicationid-changesets"></a>

## URI
<a name="applications-applicationid-changesets-url"></a>

`/applications/applicationId/changesets`

## Métodos HTTP
<a name="applications-applicationid-changesets-http-methods"></a>

### POST
<a name="applications-applicationid-changesetspost"></a>

**ID da operação:** `CreateCloudFormationChangeSet`

Cria um conjunto de AWS CloudFormation alterações para o aplicativo em questão.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 201 | ChangeSetDetails | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationid-changesetsoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-applicationid-changesets-schemas"></a>

### Corpos da solicitação
<a name="applications-applicationid-changesets-request-examples"></a>

#### Esquema POST
<a name="applications-applicationid-changesets-request-body-post-example"></a>

```
{
  "stackName": "string",
  "semanticVersion": "string",
  "templateId": "string",
  "parameterOverrides": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "capabilities": [
    "string"
  ],
  "changeSetName": "string",
  "clientToken": "string",
  "description": "string",
  "notificationArns": [
    "string"
  ],
  "resourceTypes": [
    "string"
  ],
  "rollbackConfiguration": {
    "rollbackTriggers": [
      {
        "arn": "string",
        "type": "string"
      }
    ],
    "monitoringTimeInMinutes": integer
  },
  "tags": [
    {
      "key": "string",
      "value": "string"
    }
  ]
}
```

### Corpos da resposta
<a name="applications-applicationid-changesets-response-examples"></a>

#### Esquema ChangeSetDetails
<a name="applications-applicationid-changesets-response-body-changesetdetails-example"></a>

```
{
  "applicationId": "string",
  "semanticVersion": "string",
  "changeSetId": "string",
  "stackId": "string"
}
```

#### Esquema BadRequestException
<a name="applications-applicationid-changesets-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-changesets-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-changesets-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-changesets-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-changesets-properties"></a>

### BadRequestException
<a name="applications-applicationid-changesets-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### ChangeSetDetails
<a name="applications-applicationid-changesets-model-changesetdetails"></a>

Detalhes do conjunto de alterações.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| changeSetId | string | Verdadeiro | O Amazon Resource Name (ARN) do conjunto de alterações.Restrições de tamanho: tamanho mínimo 1.Padrão: ARN: [-a-zA-z0-9:/] \$1 | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| stackId | string | Verdadeiro | O ID exclusivo da pilha. | 

### CreateCloudFormationChangeSetInput
<a name="applications-applicationid-changesets-model-createcloudformationchangesetinput"></a>

Crie uma solicitação de conjunto de alterações do aplicativo.


| Propriedade | Tipo | Obrigatório | Description | 
| --- |--- |--- |--- |
| capabilities | Matriz do tipo string | Falso | Uma lista de valores que você deve especificar antes de poder implantar determinados aplicativos. Alguns aplicativos podem incluir recursos que podem afetar as permissões em sua AWS conta, por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro.Os únicos valores válidos são `CAPABILITY_IAM` `CAPABILITY_NAMED_IAM``CAPABILITY_RESOURCE_POLICY`,, `CAPABILITY_AUTO_EXPAND` e.Os recursos a seguir exigem que você especifique `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`: [AWS::IAM::Group[AWS::IAM::InstanceProfile[AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html),, [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)e. Se o aplicativo contiver recursos do IAM, você poderá especificar `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`. Se o aplicativo contém recursos do IAM com nomes personalizados, você deverá especificar `CAPABILITY_NAMED_IAM`.Os recursos a seguir exigem que você especifique`CAPABILITY_RESOURCE_POLICY`: [AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS: :iam:Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html),,, [AWS::ApplicationAutoScaling::ScalingPolicy[AWS::S3::BucketPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), [AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)e [AWS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html): :SNS:. TopicPolicyOs aplicativos que contêm um ou mais aplicativos aninhados exigem que você especifique `CAPABILITY_AUTO_EXPAND`.Se seu modelo de aplicativo contiver algum dos recursos acima, recomendamos que você revise todas as permissões associadas ao aplicativo antes da implantação. Se você não especificar esse parâmetro para um aplicativo que requer recursos, a chamada falhará. | 
| changeSetName | string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| clientToken | string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| description | string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| notificationArns | Matriz do tipo string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| parameterOverrides | Matriz do tipo [ParameterValue](#applications-applicationid-changesets-model-parametervalue) | Falso | Uma lista de valores de parâmetros para os parâmetros do aplicativo. | 
| resourceTypes | Matriz do tipo string | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| rollbackConfiguration | [RollbackConfiguration](#applications-applicationid-changesets-model-rollbackconfiguration) | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| semanticVersion | string | Falso | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| stackName | string | Verdadeiro | Essa propriedade corresponde ao parâmetro com o mesmo nome da *CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| tags | Matriz do tipo [Tag](#applications-applicationid-changesets-model-tag) | Falso | Essa propriedade corresponde ao parâmetro com o mesmo nome da *AWS CloudFormation [CreateChangeSet](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/CreateChangeSet)*API. | 
| templateId | string | Falso | O UUID retornado por. CreateCloudFormationTemplatePadrão: [0-9a-fa-f] \$18\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$112\$1 | 

### ForbiddenException
<a name="applications-applicationid-changesets-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-changesets-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### ParameterValue
<a name="applications-applicationid-changesets-model-parametervalue"></a>

Valor do parâmetro do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| name | string | Verdadeiro | A chave associada ao parâmetro. Se você não especificar uma chave e um valor para um parâmetro específico, CloudFormation usa o valor padrão especificado no seu modelo. | 
| value | string | Verdadeiro | O valor de entrada associado ao parâmetro. | 

### RollbackConfiguration
<a name="applications-applicationid-changesets-model-rollbackconfiguration"></a>

Essa propriedade corresponde ao Tipo *CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*de dados.


| Propriedade | Tipo | Obrigatório | Description | 
| --- |--- |--- |--- |
| monitoringTimeInMinutes | integer | Falso | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*dados. | 
| rollbackTriggers | Matriz do tipo [RollbackTrigger](#applications-applicationid-changesets-model-rollbacktrigger) | Falso | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de *AWS CloudFormation [RollbackConfiguration](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackConfiguration)*dados. | 

### RollbackTrigger
<a name="applications-applicationid-changesets-model-rollbacktrigger"></a>

Essa propriedade corresponde ao Tipo *CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*de dados.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| arn | string | Verdadeiro | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*dados. | 
| type | string | Verdadeiro | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de *AWS CloudFormation [RollbackTrigger](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/RollbackTrigger)*dados. | 

### Tag
<a name="applications-applicationid-changesets-model-tag"></a>

Essa propriedade corresponde ao Tipo de Dados da *CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| key | string | Verdadeiro | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de Dados da *AWS CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 
| value | string | Verdadeiro | Essa propriedade corresponde ao conteúdo do mesmo nome para o Tipo de Dados da *AWS CloudFormation [Tag](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/Tag)*. | 

### TooManyRequestsException
<a name="applications-applicationid-changesets-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

## Consulte também
<a name="applications-applicationid-changesets-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### CreateCloudFormationChangeSet
<a name="CreateCloudFormationChangeSet-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationChangeSet)

# Applications applicationId Dependencies
<a name="applications-applicationid-dependencies"></a>

## URI
<a name="applications-applicationid-dependencies-url"></a>

`/applications/applicationId/dependencies`

## Métodos HTTP
<a name="applications-applicationid-dependencies-http-methods"></a>

### GET
<a name="applications-applicationid-dependenciesget"></a>

**ID da operação:** `ListApplicationDependencies`

Recupera a lista de aplicativos aninhados no aplicativo que o contém.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Parâmetros de consulta**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| nextToken | String | Falso | Um token para especificar onde iniciar a paginação. | 
| maxItems | String | Falso | O número total de itens a serem devolvidos. | 
| semanticVersion | String | Falso | A versão semântica do aplicativo a ser obtida. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | ApplicationDependencyPage | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationid-dependenciesoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-applicationid-dependencies-schemas"></a>

### Corpos da resposta
<a name="applications-applicationid-dependencies-response-examples"></a>

#### Esquema ApplicationDependencyPage
<a name="applications-applicationid-dependencies-response-body-applicationdependencypage-example"></a>

```
{
  "dependencies": [
    {
      "applicationId": "string",
      "semanticVersion": "string"
    }
  ],
  "nextToken": "string"
}
```

#### Esquema BadRequestException
<a name="applications-applicationid-dependencies-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-dependencies-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema NotFoundException
<a name="applications-applicationid-dependencies-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-dependencies-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-dependencies-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-dependencies-properties"></a>

### ApplicationDependencyPage
<a name="applications-applicationid-dependencies-model-applicationdependencypage"></a>

Uma lista de resumos de aplicativos aninhados no aplicativo.


| Propriedade | Tipo | Obrigatório | Description | 
| --- |--- |--- |--- |
| dependencies | Matriz do tipo [ApplicationDependencySummary](#applications-applicationid-dependencies-model-applicationdependencysummary) | Verdadeiro | Uma matriz de resumos de aplicativos aninhados no aplicativo. | 
| nextToken | string | Falso | O token para recuperação do próximo conjunto de resultados. | 

### ApplicationDependencySummary
<a name="applications-applicationid-dependencies-model-applicationdependencysummary"></a>

Um resumo aninhado do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O Amazon Resource Name (ARN) do aplicativo aninhado. | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo aninhado. | 

### BadRequestException
<a name="applications-applicationid-dependencies-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### ForbiddenException
<a name="applications-applicationid-dependencies-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-dependencies-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### NotFoundException
<a name="applications-applicationid-dependencies-model-notfoundexception"></a>

O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 404 | 
| message | string | Falso | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 

### TooManyRequestsException
<a name="applications-applicationid-dependencies-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

## Consulte também
<a name="applications-applicationid-dependencies-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### ListApplicationDependencies
<a name="ListApplicationDependencies-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/ListApplicationDependencies)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplicationDependencies)

# Política de ApplicationID de aplicativos
<a name="applications-applicationid-policy"></a>

## URI
<a name="applications-applicationid-policy-url"></a>

`/applications/applicationId/policy`

## Métodos HTTP
<a name="applications-applicationid-policy-http-methods"></a>

### GET
<a name="applications-applicationid-policyget"></a>

**ID da operação:** `GetApplicationPolicy`

Recupera a política do aplicativo.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | ApplicationPolicy | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### PUT
<a name="applications-applicationid-policyput"></a>

**ID da operação:** `PutApplicationPolicy`

Define a política de permissão para um aplicativo. Para ver a lista de ações suportadas por essa operação, consulte [Permissões do aplicativo](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/access-control-resource-based.html#application-permissions).


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | ApplicationPolicy | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationid-policyoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-applicationid-policy-schemas"></a>

### Corpos da solicitação
<a name="applications-applicationid-policy-request-examples"></a>

#### Esquema PUT
<a name="applications-applicationid-policy-request-body-put-example"></a>

```
{
  "statements": [
    {
      "statementId": "string",
      "principals": [
        "string"
      ],
      "actions": [
        "string"
      ],
      "principalOrgIDs": [
        "string"
      ]
    }
  ]
}
```

### Corpos da resposta
<a name="applications-applicationid-policy-response-examples"></a>

#### Esquema ApplicationPolicy
<a name="applications-applicationid-policy-response-body-applicationpolicy-example"></a>

```
{
  "statements": [
    {
      "statementId": "string",
      "principals": [
        "string"
      ],
      "actions": [
        "string"
      ],
      "principalOrgIDs": [
        "string"
      ]
    }
  ]
}
```

#### Esquema BadRequestException
<a name="applications-applicationid-policy-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-policy-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema NotFoundException
<a name="applications-applicationid-policy-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-policy-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-policy-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-policy-properties"></a>

### ApplicationPolicy
<a name="applications-applicationid-policy-model-applicationpolicy"></a>

Declarações de política aplicadas ao aplicativo.


| Propriedade | Tipo | Obrigatório | Description | 
| --- |--- |--- |--- |
| statements | Matriz do tipo [ApplicationPolicyStatement](#applications-applicationid-policy-model-applicationpolicystatement) | Verdadeiro | Uma série de declarações de política aplicadas ao aplicativo. | 

### ApplicationPolicyStatement
<a name="applications-applicationid-policy-model-applicationpolicystatement"></a>

Declaração de política aplicada ao aplicativo.


| Propriedade | Tipo | Obrigatório | Description | 
| --- |--- |--- |--- |
| actions | Matriz do tipo string | Verdadeiro | Para ver a lista de ações suportadas por essa operação, consulte [Permissões do aplicativo](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/access-control-resource-based.html#application-permissions). | 
| principalOrgIDs | Matriz do tipo string | Falso | O AWS Organizations ID com o qual compartilhar o aplicativo. | 
| principals | Matriz do tipo string | Verdadeiro | Uma matriz de AWS contas IDs com as quais compartilhar o aplicativo ou \$1 para tornar o aplicativo público. | 
| statementId | string | Falso | Um ID exclusivo para a declaração. | 

### BadRequestException
<a name="applications-applicationid-policy-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### ForbiddenException
<a name="applications-applicationid-policy-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-policy-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### NotFoundException
<a name="applications-applicationid-policy-model-notfoundexception"></a>

O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 404 | 
| message | string | Falso | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 

### TooManyRequestsException
<a name="applications-applicationid-policy-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

## Consulte também
<a name="applications-applicationid-policy-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### GetApplicationPolicy
<a name="GetApplicationPolicy-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/GetApplicationPolicy)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/GetApplicationPolicy)

### PutApplicationPolicy
<a name="PutApplicationPolicy-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/PutApplicationPolicy)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/PutApplicationPolicy)

# Applications applicationId Templates
<a name="applications-applicationid-templates"></a>

## URI
<a name="applications-applicationid-templates-url"></a>

`/applications/applicationId/templates`

## Métodos HTTP
<a name="applications-applicationid-templates-http-methods"></a>

### POST
<a name="applications-applicationid-templatespost"></a>

**ID da operação:** `CreateCloudFormationTemplate`

Cria um AWS CloudFormation modelo.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 201 | TemplateDetails | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationid-templatesoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-applicationid-templates-schemas"></a>

### Corpos da solicitação
<a name="applications-applicationid-templates-request-examples"></a>

#### Esquema POST
<a name="applications-applicationid-templates-request-body-post-example"></a>

```
{
  "semanticVersion": "string"
}
```

### Corpos da resposta
<a name="applications-applicationid-templates-response-examples"></a>

#### Esquema TemplateDetails
<a name="applications-applicationid-templates-response-body-templatedetails-example"></a>

```
{
  "templateId": "string",
  "templateUrl": "string",
  "applicationId": "string",
  "semanticVersion": "string",
  "status": enum,
  "creationTime": "string",
  "expirationTime": "string"
}
```

#### Esquema BadRequestException
<a name="applications-applicationid-templates-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-templates-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema NotFoundException
<a name="applications-applicationid-templates-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-templates-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-templates-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-templates-properties"></a>

### BadRequestException
<a name="applications-applicationid-templates-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### CreateCloudFormationTemplateInput
<a name="applications-applicationid-templates-model-createcloudformationtemplateinput"></a>

Crie uma solicitação de modelo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| semanticVersion | string | Falso | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 

### ForbiddenException
<a name="applications-applicationid-templates-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-templates-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### NotFoundException
<a name="applications-applicationid-templates-model-notfoundexception"></a>

O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 404 | 
| message | string | Falso | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 

### TemplateDetails
<a name="applications-applicationid-templates-model-templatedetails"></a>

Detalhes do modelo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| creationTime | string | Verdadeiro | A data e a hora em que esse recurso foi criado. | 
| expirationTime | string | Verdadeiro | A data e a hora em que esse modelo expira. Os modelos expiram 1 hora após a criação. | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| status | stringValores: `PREPARING \| ACTIVE \| EXPIRED` | Verdadeiro | Status do fluxo de trabalho de criação do modelo.Valores possíveis: `PREPARING \| ACTIVE \| EXPIRED`  | 
| templateId | string | Verdadeiro | O UUID retornado por. CreateCloudFormationTemplatePadrão: [0-9a-fa-f] \$18\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$112\$1 | 
| templateUrl | string | Verdadeiro | Um link para o modelo que pode ser usado para implantar o aplicativo usando AWS CloudFormation. | 

### TooManyRequestsException
<a name="applications-applicationid-templates-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

## Consulte também
<a name="applications-applicationid-templates-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### CreateCloudFormationTemplate
<a name="CreateCloudFormationTemplate-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateCloudFormationTemplate)

# Applications applicationId Templates templateId
<a name="applications-applicationid-templates-templateid"></a>

## URI
<a name="applications-applicationid-templates-templateid-url"></a>

`/applications/applicationId/templates/templateId`

## Métodos HTTP
<a name="applications-applicationid-templates-templateid-http-methods"></a>

### GET
<a name="applications-applicationid-templates-templateidget"></a>

**ID da operação:** `GetCloudFormationTemplate`

Obtém o AWS CloudFormation modelo especificado.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 
| templateId | String | Verdadeiro | O UUID retornado por. CreateCloudFormationTemplatePadrão: [0-9a-fa-f] \$18\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$112\$1 | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | TemplateDetails | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationid-templates-templateidoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 
| templateId | String | Verdadeiro | O UUID retornado por. CreateCloudFormationTemplatePadrão: [0-9a-fa-f] \$18\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$112\$1 | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-applicationid-templates-templateid-schemas"></a>

### Corpos da resposta
<a name="applications-applicationid-templates-templateid-response-examples"></a>

#### Esquema TemplateDetails
<a name="applications-applicationid-templates-templateid-response-body-templatedetails-example"></a>

```
{
  "templateId": "string",
  "templateUrl": "string",
  "applicationId": "string",
  "semanticVersion": "string",
  "status": enum,
  "creationTime": "string",
  "expirationTime": "string"
}
```

#### Esquema BadRequestException
<a name="applications-applicationid-templates-templateid-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-templates-templateid-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema NotFoundException
<a name="applications-applicationid-templates-templateid-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-templates-templateid-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-templates-templateid-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-templates-templateid-properties"></a>

### BadRequestException
<a name="applications-applicationid-templates-templateid-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### ForbiddenException
<a name="applications-applicationid-templates-templateid-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-templates-templateid-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### NotFoundException
<a name="applications-applicationid-templates-templateid-model-notfoundexception"></a>

O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 404 | 
| message | string | Falso | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 

### TemplateDetails
<a name="applications-applicationid-templates-templateid-model-templatedetails"></a>

Detalhes do modelo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| creationTime | string | Verdadeiro | A data e a hora em que esse recurso foi criado. | 
| expirationTime | string | Verdadeiro | A data e a hora em que esse modelo expira. Os modelos expiram 1 hora após a criação. | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| status | stringValores: `PREPARING \| ACTIVE \| EXPIRED` | Verdadeiro | Status do fluxo de trabalho de criação do modelo.Valores possíveis: `PREPARING \| ACTIVE \| EXPIRED`  | 
| templateId | string | Verdadeiro | O UUID retornado por. CreateCloudFormationTemplatePadrão: [0-9a-fa-f] \$18\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$14\$1\$1 - [0-9a-fa-f] \$112\$1 | 
| templateUrl | string | Verdadeiro | Um link para o modelo que pode ser usado para implantar o aplicativo usando AWS CloudFormation. | 

### TooManyRequestsException
<a name="applications-applicationid-templates-templateid-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

## Consulte também
<a name="applications-applicationid-templates-templateid-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### GetCloudFormationTemplate
<a name="GetCloudFormationTemplate-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/GetCloudFormationTemplate)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/GetCloudFormationTemplate)

# Applications applicationId Unshare
<a name="applications-applicationid-unshare"></a>

## URI
<a name="applications-applicationid-unshare-url"></a>

`/applications/applicationId/unshare`

## Métodos HTTP
<a name="applications-applicationid-unshare-http-methods"></a>

### POST
<a name="applications-applicationid-unsharepost"></a>

**ID da operação:** `UnshareApplication`

Cancela o compartilhamento de um aplicativo de uma AWS organização.

Essa operação só pode ser chamada da conta de gerenciamento da organização.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 204 | Nenhum | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationid-unshareoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-applicationid-unshare-schemas"></a>

### Corpos da solicitação
<a name="applications-applicationid-unshare-request-examples"></a>

#### Esquema POST
<a name="applications-applicationid-unshare-request-body-post-example"></a>

```
{
  "organizationId": "string"
}
```

### Corpos da resposta
<a name="applications-applicationid-unshare-response-examples"></a>

#### Esquema BadRequestException
<a name="applications-applicationid-unshare-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-unshare-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema NotFoundException
<a name="applications-applicationid-unshare-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-unshare-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-unshare-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-unshare-properties"></a>

### BadRequestException
<a name="applications-applicationid-unshare-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### ForbiddenException
<a name="applications-applicationid-unshare-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-unshare-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### NotFoundException
<a name="applications-applicationid-unshare-model-notfoundexception"></a>

O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 404 | 
| message | string | Falso | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 

### TooManyRequestsException
<a name="applications-applicationid-unshare-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

### UnshareApplicationInput
<a name="applications-applicationid-unshare-model-unshareapplicationinput"></a>

Cancelar o compartilhamento da solicitação do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| organizationId | string | Verdadeiro | O AWS Organizations ID do qual cancelar o compartilhamento do aplicativo. | 

## Consulte também
<a name="applications-applicationid-unshare-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### UnshareApplication
<a name="UnshareApplication-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/UnshareApplication)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/UnshareApplication)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/UnshareApplication)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/UnshareApplication)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/UnshareApplication)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/UnshareApplication)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/UnshareApplication)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/UnshareApplication)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/UnshareApplication)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/UnshareApplication)

# Versões do ApplicationID de aplicativos
<a name="applications-applicationid-versions"></a>

## URI
<a name="applications-applicationid-versions-url"></a>

`/applications/applicationId/versions`

## Métodos HTTP
<a name="applications-applicationid-versions-http-methods"></a>

### GET
<a name="applications-applicationid-versionsget"></a>

**ID da operação:** `ListApplicationVersions`

Lista as versões do aplicativo especificado.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Parâmetros de consulta**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| maxItems | String | Falso | O número total de itens a serem devolvidos. | 
| nextToken | String | Falso | Um token para especificar onde iniciar a paginação. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | ApplicationVersionPage | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 404 | NotFoundException | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationid-versionsoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-applicationid-versions-schemas"></a>

### Corpos da resposta
<a name="applications-applicationid-versions-response-examples"></a>

#### Esquema ApplicationVersionPage
<a name="applications-applicationid-versions-response-body-applicationversionpage-example"></a>

```
{
  "versions": [
    {
      "applicationId": "string",
      "semanticVersion": "string",
      "sourceCodeUrl": "string",
      "creationTime": "string"
    }
  ],
  "nextToken": "string"
}
```

#### Esquema BadRequestException
<a name="applications-applicationid-versions-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-versions-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema NotFoundException
<a name="applications-applicationid-versions-response-body-notfoundexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-versions-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-versions-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-versions-properties"></a>

### ApplicationVersionPage
<a name="applications-applicationid-versions-model-applicationversionpage"></a>

Uma lista de resumos de versões do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| nextToken | string | Falso | O token para recuperação do próximo conjunto de resultados. | 
| versions | Matriz do tipo [VersionSummary](#applications-applicationid-versions-model-versionsummary) | Verdadeiro | Uma série de resumos de versões do aplicativo. | 

### BadRequestException
<a name="applications-applicationid-versions-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### ForbiddenException
<a name="applications-applicationid-versions-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-versions-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### NotFoundException
<a name="applications-applicationid-versions-model-notfoundexception"></a>

O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 404 | 
| message | string | Falso | O recurso (por exemplo, uma declaração de política de acesso) especificado na solicitação não existe. | 

### TooManyRequestsException
<a name="applications-applicationid-versions-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

### VersionSummary
<a name="applications-applicationid-versions-model-versionsummary"></a>

Um resumo da versão do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| creationTime | string | Verdadeiro | A data e a hora em que esse recurso foi criado. | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| sourceCodeUrl | string | Falso | Um link para um repositório público para o código-fonte do seu aplicativo, por exemplo, o URL de um GitHub commit específico. | 

## Consulte também
<a name="applications-applicationid-versions-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### ListApplicationVersions
<a name="ListApplicationVersions-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/ListApplicationVersions)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/ListApplicationVersions)

# Aplicativos: ApplicationID Versions SemanticVersion
<a name="applications-applicationid-versions-semanticversion"></a>

## URI
<a name="applications-applicationid-versions-semanticversion-url"></a>

`/applications/applicationId/versions/semanticVersion`

## Métodos HTTP
<a name="applications-applicationid-versions-semanticversion-http-methods"></a>

### PUT
<a name="applications-applicationid-versions-semanticversionput"></a>

**ID da operação:** `CreateApplicationVersion`

Cria uma versão do aplicativo.


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 
| semanticVersion | String | Verdadeiro | A versão semântica da nova versão. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 201 | Version | Bem-sucedida | 
| 400 | BadRequestException | Um dos parâmetros na solicitação é inválido. | 
| 403 | ForbiddenException | O cliente não está autenticado. | 
| 409 | ConflictException | O recurso já existe. | 
| 429 | TooManyRequestsException | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 
| 500 | InternalServerErrorException | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### OPTIONS
<a name="applications-applicationid-versions-semanticversionoptions"></a>


**Parâmetros de caminho**  

| Nome | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | String | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo. | 
| semanticVersion | String | Verdadeiro | A versão semântica da nova versão. | 


**Respostas**  

| Código de status | Modelo de resposta | Description | 
| --- |--- |--- |
| 200 | Nenhum | 200 respostas | 

## Esquemas
<a name="applications-applicationid-versions-semanticversion-schemas"></a>

### Corpos da solicitação
<a name="applications-applicationid-versions-semanticversion-request-examples"></a>

#### Esquema PUT
<a name="applications-applicationid-versions-semanticversion-request-body-put-example"></a>

```
{
  "templateBody": "string",
  "templateUrl": "string",
  "sourceCodeUrl": "string",
  "sourceCodeArchiveUrl": "string"
}
```

### Corpos da resposta
<a name="applications-applicationid-versions-semanticversion-response-examples"></a>

#### Esquema Version
<a name="applications-applicationid-versions-semanticversion-response-body-version-example"></a>

```
{
  "applicationId": "string",
  "semanticVersion": "string",
  "sourceCodeUrl": "string",
  "sourceCodeArchiveUrl": "string",
  "templateUrl": "string",
  "creationTime": "string",
  "parameterDefinitions": [
    {
      "name": "string",
      "defaultValue": "string",
      "description": "string",
      "type": "string",
      "noEcho": boolean,
      "allowedPattern": "string",
      "constraintDescription": "string",
      "minValue": integer,
      "maxValue": integer,
      "minLength": integer,
      "maxLength": integer,
      "allowedValues": [
        "string"
      ],
      "referencedByResources": [
        "string"
      ]
    }
  ],
  "requiredCapabilities": [
    enum
  ],
  "resourcesSupported": boolean
}
```

#### Esquema BadRequestException
<a name="applications-applicationid-versions-semanticversion-response-body-badrequestexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ForbiddenException
<a name="applications-applicationid-versions-semanticversion-response-body-forbiddenexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema ConflictException
<a name="applications-applicationid-versions-semanticversion-response-body-conflictexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema TooManyRequestsException
<a name="applications-applicationid-versions-semanticversion-response-body-toomanyrequestsexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

#### Esquema InternalServerErrorException
<a name="applications-applicationid-versions-semanticversion-response-body-internalservererrorexception-example"></a>

```
{
  "message": "string",
  "errorCode": "string"
}
```

## Propriedades
<a name="applications-applicationid-versions-semanticversion-properties"></a>

### BadRequestException
<a name="applications-applicationid-versions-semanticversion-model-badrequestexception"></a>

Um dos parâmetros na solicitação é inválido.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 400 | 
| message | string | Falso | Um dos parâmetros na solicitação é inválido. | 

### Capability
<a name="applications-applicationid-versions-semanticversion-model-capability"></a>

Valores que devem ser especificados para implantar alguns aplicativos.
+ `CAPABILITY_IAM`
+ `CAPABILITY_NAMED_IAM`
+ `CAPABILITY_AUTO_EXPAND`
+ `CAPABILITY_RESOURCE_POLICY`

### ConflictException
<a name="applications-applicationid-versions-semanticversion-model-conflictexception"></a>

O recurso já existe.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 409 | 
| message | string | Falso | O recurso já existe. | 

### CreateApplicationVersionInput
<a name="applications-applicationid-versions-semanticversion-model-createapplicationversioninput"></a>

Crie uma solicitação de versão.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| sourceCodeArchiveUrl | string | Falso | Um link para o objeto S3 que contém o arquivo ZIP do código-fonte dessa versão do seu aplicativo.Tamanho máximo 50 MB | 
| sourceCodeUrl | string | Falso | Um link para um repositório público para o código-fonte do seu aplicativo, por exemplo, o URL de um GitHub commit específico. | 
| templateBody | string | Falso | O AWS SAM modelo empacotado bruto do seu aplicativo. | 
| templateUrl | string | Falso | Um link para o AWS SAM modelo empacotado do seu aplicativo. | 

### ForbiddenException
<a name="applications-applicationid-versions-semanticversion-model-forbiddenexception"></a>

O cliente não está autenticado.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 403 | 
| message | string | Falso | O cliente não está autenticado. | 

### InternalServerErrorException
<a name="applications-applicationid-versions-semanticversion-model-internalservererrorexception"></a>

O AWS Serverless Application Repository serviço encontrou um erro interno.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 500 | 
| message | string | Falso | O AWS Serverless Application Repository serviço encontrou um erro interno. | 

### ParameterDefinition
<a name="applications-applicationid-versions-semanticversion-model-parameterdefinition"></a>

Parâmetros suportados pelo aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| allowedPattern | string | Falso | Uma expressão regular que representa os padrões a serem permitidos para tipos `String`. | 
| allowedValues | Matriz do tipo string | Falso | Uma matriz que contém a lista de valores permitidos para o parâmetro. | 
| constraintDescription | string | Falso | Uma sequência que explica uma restrição quando a restrição é violada. Por exemplo, sem uma descrição da restrição, um parâmetro que tem um padrão permitido de `[A-Za-z0-9]+` exibe a seguinte mensagem de erro quando o usuário especifica um valor inválido: `Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+` Ao adicionar uma descrição de restrição, como “deve conter somente letras maiúsculas e minúsculas e números”, você pode exibir a seguinte mensagem de erro personalizada: `Malformed input-Parameter MyParameter must contain only uppercase and lowercase letters and numbers.`  | 
| defaultValue | string | Falso | Um valor do tipo apropriado para o modelo a ser usado se nenhum valor for especificado quando uma pilha é criada. Se definir restrições para o parâmetro, você deverá especificar um valor que esteja de acordo com essas restrições. | 
| description | string | Falso | Uma sequência de até 4.000 caracteres que descreve o parâmetro. | 
| maxLength | integer | Falso | Um valor inteiro que determina o maior número de caracteres que você deseja permitir para `String` tipos. | 
| maxValue | integer | Falso | Um valor numérico que determina o maior valor numérico que você deseja permitir para `Number` tipos. | 
| minLength | integer | Falso | Um valor inteiro que determina o menor número de caracteres que você deseja permitir para `String` tipos. | 
| minValue | integer | Falso | Um valor numérico que determina o menor valor numérico que você deseja permitir para `Number` tipos. | 
| name | string | Verdadeiro | O nome do parâmetro. | 
| noEcho | booleano | Falso | Se o valor do parâmetro deve ser mascarado sempre que alguém fizer uma chamada que descreva a pilha. Se você definir o valor como verdadeiro, o valor do parâmetro será mascarado com asteriscos (\$1\$1\$1\$1\$1). | 
| referencedByResources | Matriz do tipo string | Verdadeiro | Uma lista de AWS SAM recursos que usam esse parâmetro. | 
| type | string | Falso | O tipo do parâmetro.Valores válidos: `String \| Number \| List<Number> \| CommaDelimitedList`  `String`: Uma sequência de caracteres literal.Por exemplo, os usuários podem especificar`"MyUserName"`. `Number`: Um número inteiro ou flutuante. CloudFormation valida o valor do parâmetro como um número. No entanto, quando você usa o parâmetro em outro lugar em seu modelo (por exemplo, usando a função `Ref` intrínseca), o valor do parâmetro se torna uma string.Por exemplo, os usuários podem especificar`"8888"`. `List<Number>`: uma matriz de números inteiros ou flutuantes separados por vírgulas. CloudFormation valida o valor do parâmetro como números. No entanto, quando você usa o parâmetro em outro lugar do seu modelo (por exemplo, usando a função `Ref` intrínseca), o valor do parâmetro se torna uma lista de cadeias de caracteres.Por exemplo, os usuários podem especificar “80,20" e, em seguida, resultar em`Ref`. `["80","20"]` `CommaDelimitedList`: uma matriz de cadeias de caracteres literais separadas por vírgulas. O total de sequências deve ser um número a mais que o número total de vírgulas. Além disso, cada sequência de membros é cortada com espaço.Por exemplo, os usuários podem especificar “test, dev, prod” e, em seguida, `Ref` resultar em`["test","dev","prod"]`. | 

### TooManyRequestsException
<a name="applications-applicationid-versions-semanticversion-model-toomanyrequestsexception"></a>

O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| errorCode | string | Falso | 429 | 
| message | string | Falso | O cliente está enviando mais do que o número permitido de solicitações por unidade de tempo. | 

### Version
<a name="applications-applicationid-versions-semanticversion-model-version"></a>

Detalhes da versão do aplicativo.


| Propriedade | Tipo | Obrigatório | Descrição | 
| --- |--- |--- |--- |
| applicationId | string | Verdadeiro | O nome de recurso da Amazon (ARN) do aplicativo do . | 
| creationTime | string | Verdadeiro | A data e a hora em que esse recurso foi criado. | 
| parameterDefinitions | Matriz do tipo [ParameterDefinition](#applications-applicationid-versions-semanticversion-model-parameterdefinition) | Verdadeiro | Uma matriz de tipos de parâmetros suportados pelo aplicativo. | 
| requiredCapabilities | Matriz do tipo [Capability](#applications-applicationid-versions-semanticversion-model-capability) | Verdadeiro | Uma lista de valores que você deve especificar antes de poder implantar determinados aplicativos. Alguns aplicativos podem incluir recursos que podem afetar as permissões em sua AWS conta, por exemplo, criando novos usuários AWS Identity and Access Management (IAM). Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro.Os únicos valores válidos são `CAPABILITY_IAM` `CAPABILITY_NAMED_IAM``CAPABILITY_RESOURCE_POLICY`,, `CAPABILITY_AUTO_EXPAND` e.Os recursos a seguir exigem que você especifique `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`: [AWS::IAM::Group[AWS::IAM::InstanceProfile[AWS::IAM::Policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html),, [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)e. Se o aplicativo contiver recursos do IAM, você poderá especificar `CAPABILITY_IAM` ou`CAPABILITY_NAMED_IAM`. Se o aplicativo contém recursos do IAM com nomes personalizados, você deverá especificar `CAPABILITY_NAMED_IAM`.Os recursos a seguir exigem que você especifique`CAPABILITY_RESOURCE_POLICY`: [AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html), [AWS: :iam:policy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html),, [AWS::ApplicationAutoScaling::ScalingPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-applicationautoscaling-scalingpolicy.html), e. [AWS::S3::BucketPolicy[AWS::SQS::QueuePolicy[AWS::SNS::TopicPolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sns-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sqs-policy.html)](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html)Os aplicativos que contêm um ou mais aplicativos aninhados exigem que você especifique `CAPABILITY_AUTO_EXPAND`.Se seu modelo de aplicativo contiver algum dos recursos acima, recomendamos que você revise todas as permissões associadas ao aplicativo antes da implantação. Se você não especificar esse parâmetro para um aplicativo que requer recursos, a chamada falhará. | 
| resourcesSupported | booliano | Verdadeiro | Se todos os AWS recursos contidos nesse aplicativo são suportados na região em que ele está sendo recuperado. | 
| semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: [https://semver.org/](https://semver.org/)  | 
| sourceCodeArchiveUrl | string | Falso | Um link para o objeto S3 que contém o arquivo ZIP do código-fonte dessa versão do seu aplicativo.Tamanho máximo 50 MB | 
| sourceCodeUrl | string | Falso | Um link para um repositório público para o código-fonte do seu aplicativo, por exemplo, o URL de um GitHub commit específico. | 
| templateUrl | string | Verdadeiro | Um link para o AWS SAM modelo empacotado do seu aplicativo. | 

## Consulte também
<a name="applications-applicationid-versions-semanticversion-see-also"></a>

Para obter mais informações sobre como usar essa API em uma das referências AWS SDKs e linguagens específicas, consulte o seguinte:

### CreateApplicationVersion
<a name="CreateApplicationVersion-see-also"></a>
+ [Interface de linha de comando da AWS V2](/goto/cli2/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [SDK da AWS para .NET V4](/goto/DotNetSDKV4/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK para C\$1\$1](/goto/SdkForCpp/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [SDK da AWS para Go v2](/goto/SdkForGoV2/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK para Java V2](/goto/SdkForJavaV2/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [SDK da AWS para JavaScript V3](/goto/SdkForJavaScriptV3/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [SDK da AWS para Kotlin](/goto/SdkForKotlin/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK para PHP V3](/goto/SdkForPHPV3/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK para Python](/goto/boto3/serverlessrepo-2017-09-08/CreateApplicationVersion)
+ [AWS SDK para Ruby V3](/goto/SdkForRubyV3/serverlessrepo-2017-09-08/CreateApplicationVersion)