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á.
Aplicativos
URI
/applications
Métodos HTTP
GET
ID da operação: ListApplications
Lista os aplicativos de propriedade do solicitante.
| 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. |
| 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
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.
| 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
| Código de status | Modelo de resposta | Description |
|---|---|---|
200 | Nenhum | 200 respostas |
Esquemas
Corpos da solicitação
{ "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
{ "applications": [ { "applicationId": "string", "name": "string", "description": "string", "author": "string", "spdxLicenseId": "string", "labels": [ "string" ], "creationTime": "string", "homePageUrl": "string" } ], "nextToken": "string" }
{ "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 } }
Propriedades
Aplicação
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] |- (?! -)) * [a-z0-9])? $”; |
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 | Um 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 analisou de boa fé, como prestador de serviços razoável e prudente, as informações fornecidas pelo solicitante e confirmou que a identidade do solicitante está conforme reivindicada. |
labels | Matriz do tipo string | Falso | Rótulos para melhorar a descoberta de aplicativos nos resultados da pesquisa. Comprimento mínimo = 1. Tamanho máximo = 127. Número máximo de etiquetas: 10 Padrão: “^ [a-z A-Z0-9 +\\ -_:\\ /@] +$”; |
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 = 140 Padrão: “[a-zA-Z0-9\\ -] +”; |
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 é enviado pelo autor. |
version | Falso | Informações sobre a versão do aplicativo. |
ApplicationPage
Uma lista de detalhes do aplicativo.
| Propriedade | Tipo | Obrigatório | Description |
|---|---|---|---|
applications | Matriz do tipo ApplicationSummary | Verdadeiro | Uma variedade de resumos de aplicativos. |
nextToken | string | Falso | O token para recuperação do próximo conjunto de resultados. |
ApplicationSummary
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] |- (?! -)) * [a-z0-9])? $”; |
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 | Um 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 da pesquisa. Comprimento mínimo = 1. Tamanho máximo = 127. Número máximo de etiquetas: 10 Padrão: “^ [a-z A-Z0-9 +\\ -_:\\ /@] +$”; |
name | string | Verdadeiro | O nome da aplicação. Comprimento mínimo = 1. Comprimento máximo = 140 Padrão: “[a-zA-Z0-9\\ -] +”; |
spdxLicenseId | string | Falso | Um identificador válido de https://spdx.org/licenses/ |
BadRequestException
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. |
Recurso
Valores que devem ser especificados para implantar alguns aplicativos.
CAPABILITY_IAMCAPABILITY_NAMED_IAMCAPABILITY_AUTO_EXPANDCAPABILITY_RESOURCE_POLICY
ConflictException
O recurso já existe.
| Propriedade | Tipo | Obrigatório | Descrição |
|---|---|---|---|
errorCode | string | Falso | 409 |
message | string | Falso | O recurso já existe. |
CreateApplicationInput
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] |- (?! -)) * [a-z0-9])? $”; |
description | string | Verdadeiro | A descrição do aplicativo. Comprimento mínimo = 1. Comprimento máximo = 256 |
homePageUrl | string | Falso | Um 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 da pesquisa. Comprimento mínimo = 1. Tamanho máximo = 127. Número máximo de etiquetas: 10 Padrão: “^ [a-z A-Z0-9 +\\ -_:\\ /@] +$”; |
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 Tamanho máximo 5 MB Você pode especificar somente um dos |
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 MB Você pode especificar somente um dos |
name | string | Verdadeiro | O nome do aplicativo que você deseja publicar. Comprimento mínimo = 1. Comprimento máximo = 140 Padrão: “[a-zA-Z0-9\\ -] +”; |
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 Tamanho máximo 5 MB Você pode especificar somente um dos |
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 MB Você pode especificar somente um dos |
semanticVersion | string | Falso | A versão semântica do aplicativo: |
sourceCodeArchiveUrl | string | Falso | Um link para o objeto do 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/ |
templateBody | string | Falso | O arquivo de AWS SAM modelo em pacote bruto local do seu aplicativo. O arquivo tem o formato Você pode especificar somente um dos |
templateUrl | string | Falso | Um link para o objeto do S3 contendo o AWS SAM modelo empacotado do seu aplicativo. Você pode especificar somente um dos |
ForbiddenException
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
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
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
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 |
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
Ao adicionar uma descrição de restrição, como “deve conter somente letras e números maiúsculos e minúsculos”, você pode exibir a seguinte mensagem de erro personalizada:
|
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 |
maxValue | integer | Falso | Um valor numérico que determina o maior valor numérico que você deseja permitir para |
minLength | integer | Falso | Um valor inteiro que determina o menor número de caracteres que você deseja permitir para |
minValue | integer | Falso | Um valor numérico que determina o menor valor numérico que você deseja permitir para |
name | string | Verdadeiro | O nome do parâmetro. |
noEcho | booleano | Falso | Se deve mascarar o valor do parâmetro 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 (*****). |
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: Por exemplo, os usuários podem especificar Por exemplo, os usuários podem especificar Por exemplo, os usuários podem especificar “80,20" e, em seguida, resultar em Por exemplo, os usuários podem especificar “test, dev, prod” e depois |
TooManyRequestsException
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. |
Versão
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 | Verdadeiro | Uma matriz de tipos de parâmetros suportados pelo aplicativo. |
requiredCapabilities | Matriz do tipo Capability | Verdadeiro | Uma lista de valores que você deve especificar antes de implantar determinados aplicativos. Alguns aplicativos podem incluir recursos que podem afetar as permissões em sua AWS conta, por exemplo, criando novos AWS Identity and Access Management (IAM) usuários. Para esses aplicativos, você deve reconhecer explicitamente seus recursos especificando esse parâmetro. Os únicos valores válidos são Os seguintes recursos exigem que você especifique Os seguintes recursos exigem que você especifique Os aplicativos que contêm um ou mais aplicativos aninhados exigem que você especifique Se o modelo do 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 exige recursos, a chamada falhará. |
resourcesSupported | booliano | Verdadeiro | Se todos os AWS recursos contidos neste aplicativo são suportados na região em que estão sendo recuperados. |
semanticVersion | string | Verdadeiro | A versão semântica do aplicativo: |
sourceCodeArchiveUrl | string | Falso | Um link para o objeto do 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
Para obter mais informações sobre como usar essa API em um dos AWS SDKs e referências específicos do idioma, consulte o seguinte: