Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples ](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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á.

# AppRegistry exemplos usando AWS CLI
<a name="cli_2_service-catalog-appregistry_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with AppRegistry.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `associar-atributo-grupo`
<a name="service-catalog-appregistry_AssociateAttributeGroup_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `associate-attribute-group`.

**AWS CLI**  
**Para associar um grupo de atributos**  
O `associate-attribute-group` exemplo a seguir associa um grupo de atributos específico em sua AWS conta a um aplicativo específico em sua AWS conta.  

```
aws servicecatalog-appregistry associate-attribute-group \
    --application {{"ExampleApplication"}} \
    --attribute-group {{"ExampleAttributeGroup"}}
```
Saída:  

```
{
    "applicationArn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
    "attributeGroupArn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl"
}
```
Para obter mais informações, consulte [ Associando e desassociando grupos de atributos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/associate-attr-groups.html) no Guia do Administrador do *AWS Service Catalog AppRegistry . *  
+  Para obter detalhes da API, consulte [ AssociateAttributeGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/associate-attribute-group.html) em Referência de *AWS CLI comandos*. 

### `criar aplicativo`
<a name="service-catalog-appregistry_CreateApplication_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-application`.

**AWS CLI**  
**Para criar uma aplicação**  
O `create-application` exemplo a seguir cria um novo aplicativo em sua AWS conta.  

```
aws servicecatalog-appregistry create-application \
    --name {{"ExampleApplication"}}
```
Saída:  

```
{
    "application": {
        "id": "0ars38r6btoohvpvd9gqrptt9l",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
        "name": "ExampleApplication",
        "creationTime": "2023-02-28T21:10:10.820000+00:00",
        "lastUpdateTime": "2023-02-28T21:10:10.820000+00:00",
        "tags": {}
    }
}
```
Para obter mais informações, consulte [ Criação de aplicativos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/create-apps.html) no Guia do AppRegistry administrador do *AWS Service Catalog*.  
+  Para obter detalhes da API, consulte [ CreateApplication ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/create-application.html) em Referência de *AWS CLI comandos*. 

### `criar grupo de atributos`
<a name="service-catalog-appregistry_CreateAttributeGroup_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-attribute-group`.

**AWS CLI**  
**Para criar um grupo de atributos**  
O `create-attribute-group` exemplo a seguir cria um novo grupo de atributos em sua AWS conta.  

```
aws servicecatalog-appregistry create-attribute-group \
    --name {{"ExampleAttributeGroup"}} \
    --attributes '{{{"SomeKey1":"SomeValue1","SomeKey2":"SomeValue2"}}}'
```
Saída:  

```
{
    "attributeGroup": {
        "id": "01sj5xdwhbw54kejwnt09fnpcl",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
        "name": "ExampleAttributeGroup",
        "creationTime": "2023-02-28T20:38:01.389000+00:00",
        "lastUpdateTime": "2023-02-28T20:38:01.389000+00:00",
        "tags": {}
    }
}
```
Para obter mais informações, consulte [ Criação de grupos de atributos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/create-attr-groups.html) no Guia do AppRegistry administrador do *AWS Service Catalog*.  
+  Para obter detalhes da API, consulte [ CreateAttributeGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/create-attribute-group.html) em Referência de *AWS CLI comandos*. 

### `deletar aplicativo`
<a name="service-catalog-appregistry_DeleteApplication_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-application`.

**AWS CLI**  
**Como excluir uma aplicação**  
O `delete-application` exemplo a seguir exclui um aplicativo específico em sua AWS conta.  

```
aws servicecatalog-appregistry delete-application \
    --application {{"ExampleApplication3"}}
```
Saída:  

```
{
    "application": {
        "id": "055gw7aynr1i5mbv7kjwzx5945",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/055gw7aynr1i5mbv7kjwzx5945",
        "name": "ExampleApplication3",
        "creationTime": "2023-02-28T22:06:28.228000+00:00",
        "lastUpdateTime": "2023-02-28T22:06:28.228000+00:00"
    }
}
```
Para obter mais informações, consulte [ Excluindo aplicativos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/delete-app-details.html) no Guia * do AppRegistry Administrador do *AWS Service Catalog.  
+  Para obter detalhes da API, consulte [ DeleteApplication ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/delete-application.html) em Referência de *AWS CLI comandos*. 

### `excluir-atributo-grupo`
<a name="service-catalog-appregistry_DeleteAttributeGroup_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-attribute-group`.

**AWS CLI**  
**Exemplo 8: excluir um grupo de atributos**  
O `delete-attribute-group` exemplo a seguir exclui um grupo de atributos específico em sua AWS conta.  

```
aws servicecatalog-appregistry delete-attribute-group \
    --attribute-group {{"ExampleAttributeGroup3"}}
```
Saída:  

```
{
    "attributeGroup": {
        "id": "011ge6y3emyjijt8dw8jn6r0hv",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/011ge6y3emyjijt8dw8jn6r0hv",
        "name": "ExampleAttributeGroup3",
        "creationTime": "2023-02-28T22:05:35.224000+00:00",
        "lastUpdateTime": "2023-02-28T22:05:35.224000+00:00"
    }
}
```
Para obter mais informações, consulte [ Excluindo grupos de atributos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/delete-attr-group.html) no Guia * do AppRegistry Administrador do *AWS Service Catalog.  
+  Para obter detalhes da API, consulte [ DeleteAttributeGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/delete-attribute-group.html) em Referência de *AWS CLI comandos*. 

### `obter aplicativo`
<a name="service-catalog-appregistry_GetApplication_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-application`.

**AWS CLI**  
**Para obter uma aplicação**  
O `get-application` exemplo a seguir recupera informações de metadados sobre um aplicativo específico em sua AWS conta.  

```
aws servicecatalog-appregistry get-application \
    --application {{"ExampleApplication"}}
```
Saída:  

```
{
    "id": "0ars38r6btoohvpvd9gqrptt9l",
    "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
    "name": "ExampleApplication",
    "creationTime": "2023-02-28T21:10:10.820000+00:00",
    "lastUpdateTime": "2023-02-28T21:10:10.820000+00:00",
    "associatedResourceCount": 0,
    "tags": {
        "aws:servicecatalog:applicationName": "ExampleApplication"
    },
    "integrations": {
        "resourceGroup": {
            "state": "CREATE_COMPLETE",
            "arn": "arn:aws:resource-groups:us-west-2:813737243517:group/AWS_AppRegistry_Application-ExampleApplication"
        }
    }
}
```
Para obter mais informações, consulte Como [ usar os detalhes do aplicativo ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/access-app-details.html) no Guia do AppRegistry administrador do *AWS Service Catalog*.  
+  Para obter detalhes da API, consulte [ GetApplication ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/get-application.html) em Referência de *AWS CLI comandos*. 

### `get-attribute-group`
<a name="service-catalog-appregistry_GetAttributeGroup_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-attribute-group`.

**AWS CLI**  
**Para obter um grupo de atributos**  
O `get-attribute-group` exemplo a seguir recupera um grupo de atributos específico em sua AWS conta.  

```
aws servicecatalog-appregistry get-attribute-group \
    --attribute-group {{"ExampleAttributeGroup"}}
```
Saída:  

```
{
    "id": "01sj5xdwhbw54kejwnt09fnpcl",
    "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
    "name": "ExampleAttributeGroup",
    "attributes": "{\"SomeKey1\":\"SomeValue1\",\"SomeKey2\":\"SomeValue2\"}",
    "creationTime": "2023-02-28T20:38:01.389000+00:00",
    "lastUpdateTime": "2023-02-28T20:38:01.389000+00:00",
    "tags": {
        "aws:servicecatalog:attributeGroupName": "ExampleAttributeGroup"
    }
}
```
Para obter mais informações, consulte [ Gerenciando metadados para grupos de atributos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/manage-metatdata.html) no Guia * do AppRegistry Administrador do *AWS Service Catalog.  
+  Para obter detalhes da API, consulte [ GetAttributeGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/get-attribute-group.html) em Referência de *AWS CLI comandos*. 

### `lista de aplicativos`
<a name="service-catalog-appregistry_ListApplications_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-applications`.

**AWS CLI**  
**Para listar aplicações**  
O `list-applications` exemplo a seguir recupera uma lista de todos os aplicativos em sua AWS conta.  

```
aws servicecatalog-appregistry list-applications
```
Saída:  

```
{
    "applications": [
        {
            "id": "03axw94pjfj3uan00tcgbrxnkw",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/03axw94pjfj3uan00tcgbrxnkw",
            "name": "ExampleApplication2",
            "creationTime": "2023-02-28T21:59:34.094000+00:00",
            "lastUpdateTime": "2023-02-28T21:59:34.094000+00:00"
        },
        {
            "id": "055gw7aynr1i5mbv7kjwzx5945",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/055gw7aynr1i5mbv7kjwzx5945",
            "name": "ExampleApplication3",
            "creationTime": "2023-02-28T22:06:28.228000+00:00",
            "lastUpdateTime": "2023-02-28T22:06:28.228000+00:00"
        },
        {
            "id": "0ars38r6btoohvpvd9gqrptt9l",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
            "name": "ExampleApplication",
            "description": "This is an example application",
            "creationTime": "2023-02-28T21:10:10.820000+00:00",
            "lastUpdateTime": "2023-02-28T21:24:19.729000+00:00"
        }
    ]
}
```
Para obter mais informações, consulte [ Exibindo detalhes do aplicativo ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/view-app-details.html) no Guia do AppRegistry administrador do *AWS Service Catalog*.  
+  Para obter detalhes da API, consulte [ ListApplications ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-applications.html) em Referência de *AWS CLI comandos*. 

### `grupos de atributos associados à lista`
<a name="service-catalog-appregistry_ListAssociatedAttributeGroups_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-associated-attribute-groups`.

**AWS CLI**  
**Para listar grupos de atributos associados**  
O `list-associated-attribute-groups` exemplo a seguir recupera uma lista de todos os grupos de atributos em sua AWS conta que estão associados a um aplicativo específico em sua AWS conta.  

```
aws servicecatalog-appregistry list-associated-attribute-groups \
    --application {{"ExampleApplication"}}
```
Saída:  

```
{
    "attributeGroups": [
        "01sj5xdwhbw54kejwnt09fnpcl"
    ]
}
```
Para obter mais informações, consulte [ Associando e desassociando grupos de atributos ](https://https://docs.aws.amazon.com/servicecatalog/latest/arguide/associate-attr-groups.html) no Guia do Administrador do *AWS Service Catalog AppRegistry . *  
+  Para obter detalhes da API, consulte [ ListAssociatedAttributeGroups ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-associated-attribute-groups.html) em Referência de *AWS CLI comandos*. 

### `lista de grupos de atributos para aplicativo`
<a name="service-catalog-appregistry_ListAttributeGroupsForApplication_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-attribute-groups-for-application`.

**AWS CLI**  
**Para listar grupos de atributos para uma aplicação**  
O `list-attribute-groups-for-application` exemplo a seguir lista os detalhes de todos os grupos de atributos em sua AWS conta que estão associados a um aplicativo específico em sua AWS conta.  

```
aws servicecatalog-appregistry list-attribute-groups-for-application \
    --application {{"ExampleApplication"}}
```
Saída:  

```
{
    "attributeGroupsDetails": [
        {
            "id": "01sj5xdwhbw54kejwnt09fnpcl",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
            "name": "ExampleAttributeGroup"
        }
    ]
}
```
Para obter mais informações, consulte [ Exibindo detalhes do grupo de atributos ](https://servicecatalog/latest/arguide/view-attr-group.html) no Guia do AppRegistry Administrador do *AWS Service Catalog*.  
+  Para obter detalhes da API, consulte [ ListAttributeGroupsForApplication ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-attribute-groups-for-application.html) em Referência de *AWS CLI comandos*. 

### `grupos de atributos de lista`
<a name="service-catalog-appregistry_ListAttributeGroups_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-attribute-groups`.

**AWS CLI**  
**Para listar grupos de atributos**  
O `list-attribute-groups` exemplo a seguir recupera uma lista de todos os grupos de atributos em sua AWS conta.  

```
aws servicecatalog-appregistry list-attribute-groups
```
Saída:  

```
{
    "attributeGroups": [
        {
            "id": "011ge6y3emyjijt8dw8jn6r0hv",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/011ge6y3emyjijt8dw8jn6r0hv",
            "name": "ExampleAttributeGroup3",
            "creationTime": "2023-02-28T22:05:35.224000+00:00",
            "lastUpdateTime": "2023-02-28T22:05:35.224000+00:00"
        },
        {
            "id": "01sj5xdwhbw54kejwnt09fnpcl",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
            "name": "ExampleAttributeGroup",
            "description": "This is an example attribute group",
            "creationTime": "2023-02-28T20:38:01.389000+00:00",
            "lastUpdateTime": "2023-02-28T21:02:04.559000+00:00"
        },
        {
            "id": "03n1yffgq6d18vwrzxf0c70nm3",
            "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/03n1yffgq6d18vwrzxf0c70nm3",
            "name": "ExampleAttributeGroup2",
            "creationTime": "2023-02-28T21:57:30.687000+00:00",
            "lastUpdateTime": "2023-02-28T21:57:30.687000+00:00"
        }
    ]
}
```
Para obter mais informações, consulte [ Exibindo detalhes do grupo de atributos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/view-attr-group.html) no Guia do AppRegistry Administrador do *AWS Service Catalog*.  
+  Para obter detalhes da API, consulte [ ListAttributeGroups ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/list-attribute-groups.html) em Referência de *AWS CLI comandos*. 

### `aplicativo de atualização`
<a name="service-catalog-appregistry_UpdateApplication_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `update-application`.

**AWS CLI**  
**Para atualizar uma aplicação**  
O `update-application` exemplo a seguir atualiza um aplicativo específico em sua AWS conta para incluir uma descrição.  

```
aws servicecatalog-appregistry update-application \
    --application {{"ExampleApplication"}} \
    --description {{"This is an example application"}}
```
Saída:  

```
{
    "application": {
        "id": "0ars38r6btoohvpvd9gqrptt9l",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/applications/0ars38r6btoohvpvd9gqrptt9l",
        "name": "ExampleApplication",
        "description": "This is an example application",
        "creationTime": "2023-02-28T21:10:10.820000+00:00",
        "lastUpdateTime": "2023-02-28T21:24:19.729000+00:00",
        "tags": {
            "aws:servicecatalog:applicationName": "ExampleApplication"
        }
    }
}
```
Para obter mais informações, consulte [ Editando aplicativos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/edit-apps.html) no Guia do AppRegistry Administrador do *AWS Service Catalog*.  
+  Para obter detalhes da API, consulte [ UpdateApplication ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/update-application.html) em Referência de *AWS CLI comandos*. 

### `grupo de atributos de atualização`
<a name="service-catalog-appregistry_UpdateAttributeGroup_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `update-attribute-group`.

**AWS CLI**  
**Para atualizar um grupo de atributos**  
O `update-attribute-group` exemplo a seguir atualiza um grupo de atributos específico em sua AWS conta para incluir uma descrição.  

```
aws servicecatalog-appregistry update-attribute-group \
    --attribute-group {{"ExampleAttributeGroup"}} \
    --description {{"This is an example attribute group"}}
```
Saída:  

```
{
    "attributeGroup": {
        "id": "01sj5xdwhbw54kejwnt09fnpcl",
        "arn": "arn:aws:servicecatalog:us-west-2:813737243517:/attribute-groups/01sj5xdwhbw54kejwnt09fnpcl",
        "name": "ExampleAttributeGroup",
        "description": "This is an example attribute group",
        "creationTime": "2023-02-28T20:38:01.389000+00:00",
        "lastUpdateTime": "2023-02-28T21:02:04.559000+00:00",
        "tags": {
            "aws:servicecatalog:attributeGroupName": "ExampleAttributeGroup"
        }
    }
}
```
Para obter mais informações, consulte [ Editando grupos de atributos ](https://docs.aws.amazon.com/servicecatalog/latest/arguide/edit-attr-group.html) no Guia do AppRegistry Administrador do *AWS Service Catalog*.  
+  Para obter detalhes da API, consulte [ UpdateAttributeGroup ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/servicecatalog-appregistry/update-attribute-group.html) em Referência de *AWS CLI comandos*.