O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 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á. # CreateExplainability **nota** A explicabilidade só está disponível para previsões e preditores gerados a partir de um () AutoPredictor [CreateAutoPredictor](API_CreateAutoPredictor.md) Cria uma explicabilidade do Amazon Forecast. **Importante** O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) A explicabilidade ajuda você a entender melhor como os atributos em seus conjuntos de dados afetam a previsão. O Amazon Forecast usa uma métrica chamada Impact scores para quantificar o impacto relativo de cada atributo e determinar se eles aumentam ou diminuem os valores da previsão. Para habilitar a explicabilidade da previsão, seu preditor deve incluir pelo menos um dos seguintes elementos: séries temporais relacionadas, metadados de itens ou conjuntos de dados adicionais, como Holidays, e o Weather Index. **nota** Os modelos ARIMA (AutoRegressive Integrated Moving Average), ETS (Exponential Smoothing State Space Model) e NPTS (Non-Parametric Time Series) não incorporam dados externos de séries temporais. Portanto, esses modelos não criam um relatório de explicabilidade, mesmo se você incluir os conjuntos de dados adicionais. CreateExplainability aceita um ARN do Predictor ou do Forecast ARN. Para receber pontuações de impacto agregadas para todas as séries temporais e pontos no tempo em seus conjuntos de dados, forneça o ARN de um preditor. Para receber pontuações de impacto para séries temporais e pontos no tempo específicos, forneça o ARN de uma previsão. **CreateExplainability com um ARN do Predictor** **nota** Você só pode ter um recurso de explicabilidade por preditor. Se você já habilitou `ExplainPredictor` em [CreateAutoPredictor](API_CreateAutoPredictor.md), esse preditor já tem um recurso de explicabilidade. Os seguintes parâmetros são obrigatórios ao fornecer o ARN de um preditor: + `ExplainabilityName` - Um nome exclusivo para a explicabilidade. + `ResourceArn` - O ARN do preditor. + `TimePointGranularity` - Deve ser definido como “ALL”. + `TimeSeriesGranularity` - Deve ser definido como “ALL”. Não especifique um valor para os seguintes parâmetros: + `DataSource`- Só é válido quando TimeSeriesGranularity é “ESPECÍFICO”. + `Schema`- Só é válido quando TimeSeriesGranularity é “ESPECÍFICO”. + `StartDateTime`- Só é válido quando TimePointGranularity é “ESPECÍFICO”. + `EndDateTime`- Só é válido quando TimePointGranularity é “ESPECÍFICO”. **CreateExplainability com um Forecast ARN** **nota** Você pode especificar um máximo de 50 séries temporais e 500 pontos no tempo. Os seguintes parâmetros são obrigatórios ao fornecer o ARN de um preditor: + `ExplainabilityName` - Um nome exclusivo para a explicabilidade. + `ResourceArn` - O Arn da previsão. + `TimePointGranularity` - “ALL” ou “SPECIFIC”. + `TimeSeriesGranularity` - “ALL” ou “SPECIFIC”. Se você TimeSeriesGranularity definir como “ESPECÍFICO”, também deverá fornecer o seguinte: + `DataSource` - O local do S3 do arquivo CSV que especifica sua série temporal. + `Schema` - O esquema define os atributos e os tipos de atributo listados na fonte de dados. Se você TimePointGranularity definir como “ESPECÍFICO”, também deverá fornecer o seguinte: + `StartDateTime` - O primeiro carimbo de data e hora na faixa de pontos no tempo. + `EndDateTime` - O último carimbo de data e hora na faixa de pontos no tempo. ## Sintaxe da solicitação ``` { "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "EnableVisualization": boolean, "EndDateTime": "string", "ExplainabilityConfig": { "TimePointGranularity": "string", "TimeSeriesGranularity": "string" }, "ExplainabilityName": "string", "ResourceArn": "string", "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "StartDateTime": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Parâmetros da solicitação A solicitação aceita os dados a seguir no formato JSON. ** [DataSource](#API_CreateExplainability_RequestSyntax) ** A fonte dos seus dados, uma função AWS Identity and Access Management (IAM) que permite ao Amazon Forecast acessar os dados e, opcionalmente, uma chave AWS Key Management Service (KMS). Tipo: objeto [DataSource](API_DataSource.md) Obrigatório: não ** [EnableVisualization](#API_CreateExplainability_RequestSyntax) ** Crie uma visualização de explicabilidade que possa ser visualizada no console. AWS Tipo: booliano Obrigatório: não ** [EndDateTime](#API_CreateExplainability_RequestSyntax) ** Se `TimePointGranularity` for definido como `SPECIFIC`, defina o último ponto no tempo para a explicabilidade. Use o seguinte formato de timestamp ::mm:ss (exemplo: 2015-01-01T 20:00:00) yyyy-MM-ddTHH Tipo: string Restrições de tamanho: o tamanho máximo é 19. Padrão: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` Obrigatório: não ** [ExplainabilityConfig](#API_CreateExplainability_RequestSyntax) ** As configurações que definem a granularidade das séries temporais e dos pontos no tempo para a explicabilidade. Tipo: objeto [ExplainabilityConfig](API_ExplainabilityConfig.md) Obrigatório: Sim ** [ExplainabilityName](#API_CreateExplainability_RequestSyntax) ** Um nome exclusivo para a explicabilidade. Tipo: string Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63. Padrão: `^[a-zA-Z][a-zA-Z0-9_]*` Obrigatório: Sim ** [ResourceArn](#API_CreateExplainability_RequestSyntax) ** O nome do recurso da Amazon (ARN) do preditor ou da previsão usado para criar a explicabilidade. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+` Obrigatório: Sim ** [Schema](#API_CreateExplainability_RequestSyntax) ** Define os campos de um conjunto de dados. Tipo: objeto [Schema](API_Schema.md) Obrigatório: não ** [StartDateTime](#API_CreateExplainability_RequestSyntax) ** Se `TimePointGranularity` for definido como `SPECIFIC`, defina o primeiro ponto para a explicabilidade. Use o seguinte formato de timestamp ::mm:ss (exemplo: 2015-01-01T 20:00:00) yyyy-MM-ddTHH Tipo: string Restrições de tamanho: o tamanho máximo é 19. Padrão: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$` Obrigatório: não ** [Tags](#API_CreateExplainability_RequestSyntax) ** Metadados opcionais que ajudam você a categorizar e organizar seus recursos. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos. As chaves e valores das tags diferenciam maiúsculas de minúsculas. As restrições a seguir se aplicam às tags: + Em todos os recursos, cada chave de tag deve ser exclusiva e ter apenas um valor. + Número máximo de tags por recurso: 50. + Comprimento máximo da chave: 128 caracteres Unicode em UTF-8. + Comprimento máximo do valor: 256 caracteres Unicode em UTF-8. + Caracteres aceitos: todas as letras, números e espaços representáveis em UTF-8 e os símbolos \$1 - = . \$1 : / @. Se seu esquema de tags for usado em outros serviços e recursos, as restrições de caracteres desses serviços também serão aplicáveis. + Os prefixos de teclas não podem incluir nenhuma combinação de letras maiúsculas ou minúsculas de `aws:` ou `AWS:`. Os valores podem ter esse prefixo. Se um valor de tag tiver `aws` como prefixo, mas a chave não, o Forecast o considerará uma tag de usuário e o contabilizará no limite de 50 tags. As tags que têm apenas o prefixo de chave `aws` não são contabilizadas entre suas tags por limite de recurso. Você não pode editar nem excluir chaves de tag com esse prefixo. Tipo: matriz de objetos [Tag](API_Tag.md) Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens. Obrigatório: não ## Sintaxe da resposta ``` { "ExplainabilityArn": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [ExplainabilityArn](#API_CreateExplainability_ResponseSyntax) ** O nome do recurso da Amazon (ARN) da explicabilidade. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+` ## Erros ** InvalidInputException ** Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido. Código de status HTTP: 400 ** LimitExceededException ** O limite do número de recursos por conta foi excedido. Código de status HTTP: 400 ** ResourceAlreadyExistsException ** Já existe um recurso com esse nome. Tente novamente com outro nome. Código de status HTTP: 400 ** ResourceInUseException ** O recurso especificado está em uso. Código de status HTTP: 400 ** ResourceNotFoundException ** Não conseguimos encontrar um recurso com esse nome do recurso da Amazon (ARN). Verifique o ARN e tente novamente. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateExplainability) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateExplainability) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateExplainability) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateExplainability) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateExplainability) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateExplainability) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateExplainability) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateExplainability) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateExplainability) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateExplainability)