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á.
CreateIngestion
Cria e inicia uma nova ingestão de SPICE para um conjunto de dados. Você pode atualizar manualmente os conjuntos de dados em uma conta da edição Enterprise 32 vezes em um período de 24 horas. Você pode atualizar manualmente os conjuntos de dados em uma conta da edição Standard 8 vezes em um período de 24 horas. Cada período de 24 horas é medido a partir de 24 horas antes da data e hora atuais.
Todas as ingestões que operam em conjuntos de dados marcados herdam as mesmas tags automaticamente para uso no controle de acesso. Para ver um exemplo, consulteComo faço para criar uma política do IAM para controlar o acesso aos recursos do Amazon EC2 usando tags?
Sintaxe da solicitação
PUT /accounts/AwsAccountId/data-sets/DataSetId/ingestions/IngestionId HTTP/1.1
Content-type: application/json
{
"IngestionType": "string"
}Parâmetros da solicitação de URI
A solicitação usa os parâmetros de URI a seguir.
- AwsAccountId
-
O ID da conta da AWS.
Restrições de tamanho: Comprimento fixo de 12.
Padrão:
^[0-9]{12}$Obrigatório: Sim
- DataSetId
-
O ID do conjunto de dados usado na ingestão.
Obrigatório: Sim
- IngestionId
-
Uma identificação para a ingestão.
Restrições de tamanho: Tamanho mínimo de 1. Tamanho máximo de 128.
Padrão:
^[a-zA-Z0-9-_]+$Obrigatório: Sim
Corpo da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- IngestionType
-
O tipo de ingestão que você deseja criar.
Type: String
Valores válidos:
INCREMENTAL_REFRESH | FULL_REFRESHObrigatório: Não
Sintaxe da resposta
HTTP/1.1 Status
Content-type: application/json
{
"Arn": "string",
"IngestionId": "string",
"IngestionStatus": "string",
"RequestId": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará a resposta HTTP a seguir.
- Status
-
O status HTTP da solicitação.
Os seguintes dados são retornados no formato JSON pelo serviço.
- Arn
-
O nome de recurso da Amazon (ARN) para a ingestão de dados.
Type: String
- IngestionId
-
Uma identificação para a ingestão.
Type: String
Restrições de tamanho: Tamanho mínimo de 1. Tamanho máximo de 128.
Padrão:
^[a-zA-Z0-9-_]+$ - IngestionStatus
-
O status da ingestão.
Type: String
Valores válidos:
INITIALIZED | QUEUED | RUNNING | FAILED | COMPLETED | CANCELLED - RequestId
-
OAWSID da solicitação para essa operação.
Type: String
Erros
Para obter informações sobre os erros que são comuns a todas as ações, consulteErros comuns.
- AccessDeniedException
-
Você não tem acesso a esse item. Não foi possível validar as credenciais fornecidas. Talvez você não tenha permissão para executar a solicitação. Verifique se sua conta está autorizada a usar a Amazon QuickSight , se as suas políticas têm as permissões corretas e se você está usando as chaves de acesso corretas.
Código de status HTTP: 401
- InternalFailureException
-
Ocorreu um erro interno.
Código de status HTTP: 500
- InvalidParameterValueException
-
Um ou mais parâmetros têm um valor que não é válido.
Código de status HTTP: 400
- LimitExceededException
-
Um limite foi excedido.
Código de status HTTP: 409
- ResourceExistsException
-
O recurso especificado já existe.
Código de status HTTP: 409
- ResourceNotFoundException
-
Não foi possível encontrar um ou mais recursos.
Código de status HTTP: 404
- ThrottlingException
-
O acesso é limitado.
Código de status HTTP: 429
Exemplos
Exemplo
Este exemplo ilustra um uso de CreateIngestion.
Exemplo de solicitação
PUT /accounts/*AwsAccountId*/data-sets/*DataSetID*/ingestions/*IngestionID* HTTP/1.1Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
