# Exemplos do Device Farm usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Device Farm.
*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
### `create-device-pool`
O código de exemplo a seguir mostra como usar `create-device-pool`.
**AWS CLI**
**Para criar um grupo de dispositivos**
O comando a seguir cria um grupo de dispositivos Android para um projeto:
```
aws devicefarm create-device-pool --name pool1 --rules file://device-pool-rules.json --project-arn "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506"
```
É possível obter o ARN do projeto a partir da saída de `create-project` ou `list-projects`. O arquivo `device-pool-rules.json` é um documento JSON na pasta atual que especifica a plataforma do dispositivo:
```
[
{
"attribute": "PLATFORM",
"operator": "EQUALS",
"value": "\"ANDROID\""
}
]
```
Resultado:
```
{
"devicePool": {
"rules": [
{
"operator": "EQUALS",
"attribute": "PLATFORM",
"value": "\"ANDROID\""
}
],
"type": "PRIVATE",
"name": "pool1",
"arn": "arn:aws:devicefarm:us-west-2:123456789012:devicepool:070fc3ca-7ec1-4741-9c1f-d3e044efc506/2aa8d2a9-5e73-47ca-b929-659cb34b7dcd"
}
}
```
+ Para ver detalhes da API, consulte [CreateDevicePool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/create-device-pool.html) na *Referência de comandos da AWS CLI*.
### `create-project`
O código de exemplo a seguir mostra como usar `create-project`.
**AWS CLI**
**Para criar um projeto**
O seguinte comando cria um projeto chamado `my-project`:
```
aws devicefarm create-project --name my-project
```
Resultado:
```
{
"project": {
"name": "myproject",
"arn": "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506",
"created": 1503612890.057
}
}
```
+ Consulte detalhes da API em [CreateProject](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/create-project.html) na *Referência de comandos da AWS CLI*.
### `create-upload`
O código de exemplo a seguir mostra como usar `create-upload`.
**AWS CLI**
**Para criar um upload**
O comando a seguir cria um upload para uma aplicação do Android:
```
aws devicefarm create-upload --project-arn "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506" --name app.apk --type ANDROID_APP
```
É possível obter o ARN do projeto a partir da saída de create-project ou list-projects.
Resultado:
```
{
"upload": {
"status": "INITIALIZED",
"name": "app.apk",
"created": 1503614408.769,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789012%3Aproject%3A070fc3ca-c7e1-4471-91cf-d3e4efc50604/uploads/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789012%3Aupload%3A070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514/app.apk?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20170824T224008Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=AKIAEXAMPLEPBUMBC3GA%2F20170824%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=05050370c38894ef5bd09f5d009f36fc8f96fa4bb04e1bba9aca71b8dbe49a0f",
"type": "ANDROID_APP",
"arn": "arn:aws:devicefarm:us-west-2:123456789012:upload:070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514"
}
}
```
Use o URL assinado na saída para carregar um arquivo no Device Farm:
```
curl -T app.apk "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789012%3Aproject%3A070fc3ca-c7e1-4471-91cf-d3e4efc50604/uploads/arn%3Aaws%3Adevicefarm%3Aus-west-2%3A123456789012%3Aupload%3A070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514/app.apk?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20170824T224008Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=AKIAEXAMPLEPBUMBC3GA%2F20170824%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=05050370c38894ef5bd09f5d009f36fc8f96fa4bb04e1bba9aca71b8dbe49a0f"
```
+ Para ver detalhes da API, consulte [CreateUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/create-upload.html) na *Referência de comandos da AWS CLI*.
### `get-upload`
O código de exemplo a seguir mostra como usar `get-upload`.
**AWS CLI**
**Como visualizar um upload**
O comando a seguir recupera informações sobre um upload:
```
aws devicefarm get-upload --arn "arn:aws:devicefarm:us-west-2:123456789012:upload:070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514"
```
É possível obter o ARN de upload a partir da saída de `create-upload`.
Resultado:
```
{
"upload": {
"status": "SUCCEEDED",
"name": "app.apk",
"created": 1505262773.186,
"type": "ANDROID_APP",
"arn": "arn:aws:devicefarm:us-west-2:123456789012:upload:070fc3ca-7ec1-4741-9c1f-d3e044efc506/dd72723a-ae9e-4087-09e6-f4cea3599514",
"metadata": "{\"device_admin\":false,\"activity_name\":\"ccom.example.client.LauncherActivity\",\"version_name\":\"1.0.2.94\",\"screens\":[\"small\",\"normal\",\"large\",\"xlarge\"],\"error_type\":null,\"sdk_version\":\"16\",\"package_name\":\"com.example.client\",\"version_code\":\"20994\",\"native_code\":[\"armeabi-v7a\"],\"target_sdk_version\":\"25\"}"
}
}
```
+ Para ver detalhes da API, consulte [GetUpload](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/get-upload.html) na *Referência de comandos da AWS CLI*.
### `list-projects`
O código de exemplo a seguir mostra como usar `list-projects`.
**AWS CLI**
**Para listar projetos**
A opção seguinte recupera uma lista de projetos:
```
aws devicefarm list-projects
```
Resultado:
```
{
"projects": [
{
"name": "myproject",
"arn": "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506",
"created": 1503612890.057
},
{
"name": "otherproject",
"arn": "arn:aws:devicefarm:us-west-2:123456789012:project:a5f5b752-8098-49d1-86bf-5f7682c1c77e",
"created": 1505257519.337
}
]
}
```
+ Para ver detalhes da API, consulte [ListProjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/devicefarm/list-projects.html) na *Referência de comandos da AWS CLI*.