

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>

### `associate-attribute-group`
<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 *AWS Service Catalog Administrator Guide*. 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*. 

### `create-application`
<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 *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `create-attribute-group`
<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 na 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 *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `delete-application`
<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 da 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 *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `delete-attribute-group`
<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 *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `get-application`
<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 [Usando detalhes do aplicativo](https://docs.aws.amazon.com/servicecatalog/latest/arguide/access-app-details.html) no *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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 [Gerenciamento de metadados para grupos de atributos](https://docs.aws.amazon.com/servicecatalog/latest/arguide/manage-metatdata.html) no *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `list-applications`
<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 [Visualizando detalhes do aplicativo](https://docs.aws.amazon.com/servicecatalog/latest/arguide/view-app-details.html) no *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `list-associated-attribute-groups`
<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 *AWS Service Catalog Administrator Guide*. 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*. 

### `list-attribute-groups-for-application`
<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 [Visualizando detalhes do grupo de atributos](https://servicecatalog/latest/arguide/view-attr-group.html) no *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `list-attribute-groups`
<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 [Visualizando detalhes do grupo de atributos](https://docs.aws.amazon.com/servicecatalog/latest/arguide/view-attr-group.html) no *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `update-application`
<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 *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 

### `update-attribute-group`
<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 *AWS Service Catalog AppRegistry Administrator Guide*.  
+  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*. 