ASK CLIコマンドリファレンス(v2)



ASK CLIコマンドリファレンス

このリファレンスでは、ASK CLIで利用できるすべてのコマンドについて説明します。ASK CLIについては、ASK CLIの概要を参照してください。Alexa Skills Kitコマンドラインインターフェース(ASK CLI)を使って開発を始めるには、ASK CLIクイックスタートを参照してください。

概要

ASK CLIコマンドの有効な構文は次のとおりです。

$ ask [オプション]
$ ask [コマンド] [オプション]
$ ask [コマンド] [サブコマンド] [オプション]

開発者アカウントに関連付けられたスキルを処理するASK CLIのコマンドには、2つの種類があります。

  • 高レベルコマンドは、詳細を抽象化し、複数のアクションを実行することで、Alexaスキルのプロジェクト作業効率を向上させます。スキル開発が初めての方や、API呼び出しを細かく制御する必要がない場合は、これらのコマンドが適しています。高レベルコマンドの例として、newdeployconfigureがあります。

  • 低レベルコマンドは、Alexaスキルを詳細に管理するために使用します。Alexaスキル管理API(SMAPI)操作のラッパーとして機能するため、各API呼び出しを制御できます。既にアカウントに追加したスキルの一部を変更する場合に便利です。smapiコマンドのサブコマンドは、低レベルコマンドです。

コンピューターにインストールされているASK CLIのバージョン番号を取得するには、次のように--versionオプションを使用します。

$ ask [--version | -V]

共通パラメーター

ASK CLIコマンドには、--help--debugなどの共通のパラメーターがあります。共通パラメーターは、各コマンドで同じ動作をします。このセクションでは、共通パラメーターについて説明します。

コマンドのデバッグモード

ほとんどのコマンドは、説明に記載されているとおり、デバッグモードで実行できます。デバッグモードにするには、コマンドに--debugを追加します。コマンドの実行完了後にデバッグメッセージが表示される(標準エラー出力に送られる)以外は、–debugを指定しない場合と同じ結果が表示されます。このデバッグメッセージは、次のフィールドで構成されます。timestampapi-namerequest-idmethodurlresponse-coderequest-headerrequest-bodyresponse-headerresponse-body

これらの結果を保存するには、コマンドを実行し、パイプを使って以下のように出力をローカルテキストファイルに送ります。

$ ask [コマンド] <パラメーター> --debug 2> debug.txt

コマンドのヘルプモード

各ASK CLIコマンドでは、コマンドに--helpを追加することで、その目的とオプションに関するヘルプが提供されます。ヘルプモードでコマンドを実行した場合、コマンド自体は実行されません。

 $ ask [コマンド] --help

スキルのステージ

ASK CLIコマンドの多くはスキルのstageを参照します。stageの値は、developmentliveのいずれかです。developmentの場合、スキルは公開されていません。liveの場合、スキルは公開済みですが、実際に公開中のもの、ユーザーには非表示になっているもの、スキルストアから削除されたもののいずれかの可能性があります。詳細については、公開ステータスを参照してください。

configureコマンド

Amazon開発者アカウント認証情報を使ってASK CLIを初期化します。スキル操作を実行する前に開発者アカウントの認証情報を使用してツールを初期化するには、このコマンドを実行します。このコマンドはポート9090を使用します。ポートが使用中の場合、エラーになります。

ask configureコマンドでは、認証情報を設定できます。ASK CLIは、この認証情報をAmazon開発者サービスやアマゾンウェブサービス(AWS)の認証に使います。この対話形式のコマンドを使うと、ウェブブラウザが開きます。Amazon開発者アカウントでサインインすると、使用する認証情報に関する情報を入力するか、質問に答えるようプロンプトが出ます。

ask configureを使うと、別のAmazonアカウントやAWSアカウントの認証情報を含むプロファイルの表示や設定ができます。プロファイルでは、ASK CLIを使って別のアカウントで作成したスキルを管理できます。ask newask deployなどのコマンドに-pまたは--profileオプションを付けて使用します。

ASK CLIがAmazon開発者アカウントやAWSアカウントの認証情報を保存、管理する方法については、ASK CLIを使った認証情報の管理を参照してください。

構文

ask configure [--profile | -p <プロファイル>]
              [--no-browser]
              [--debug]
              [--help | -h]

オプション

--list-profiles、-l
任意です。ASK CLIが使用可能なプロファイルのリストを表示します。
--profile, -p
任意です。設定する認証情報に使うプロファイルを指定します。このオプションを省略すると、リストからプロファイルを選択するか、新規作成するようASK CLIのプロンプトが出ます。
--no-browser
任意です。このオプションを使うと、ask initコマンドをウェブブラウザを持たないコンピューターで実行できます。ASK CLIにURLが表示されるので、別のコンピューターのウェブブラウザを使ってこのURLにアクセスし、Amazon開発者アカウントでサインインできます。サインインすると、ブラウザにコードが表示されるので、コマンドラインに入力して認証情報の設定を完了します。
--aws-setup
任意です。このオプションを使うと、Amazon開発者認証情報の設定を省略し、AWS認証情報のみを設定できます。

deployコマンド

スキルのマニフェスト、音声対話モデル、AWS Lambda関数を含むスキルを開発者アカウントにデプロイします。概要と使用例については、ASK CLIの概要でスキルプロジェクトを開発中ステージにデプロイするを参照してください。

構文

ask deploy [-p | --profile <プロファイル>]
           [--ignore-hash]
           [--debug]
           [--help | -h]

オプション

--profile, -p
任意です。ASK CLIがスキルリソースをデプロイするプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--ignore-hash
任意です。変更がない場合でも、スキルを強制的に再度デプロイします。

dialogコマンド

開発者がAlexaとのマルチターンの会話をシミュレートできるダイアログモードを開始します。各ダイアログはsimulate-skillを使用します。これは、シミュレーション結果が入手できるまでポーリングを続ける非同期の操作です。結果を入手したら、Alexaのテキスト応答を表示します。パラメーターが無効な場合、対話モードは開始しません。また、ユーザーが特殊コマンドの「!quit」かCtrl+Cを入力しない限り終了しません。

ユーザーがダイアログ中に入力できるコマンドは2つあります。1つは.quitで、対話モードを終了します。もう1つは.recordで、ユーザーにファイル名を入力するようプロンプトを出し、ダイアログ入力を記録できます。これらのコマンドは、現在の対話モードのスキルID、ロケール、入力タイプ、すべての入力テキストと共に使用できます。.recordコマンドは、最後のセッションのユーザー入力のみを記録します。

このコマンドを--replayオプションを付けて実行する場合、スキルの情報とユーザー入力を含む再生ファイルを指定します。replayオプションはユーザー入力を再生し、Alexaが通常の会話のように応答します。再生ファイル形式を参照してください。コマンドラインでskillIdを指定しないでください。

このコマンドを--replayオプションを付けないで実行する場合、指定したスキルのリクエストをAlexaに話し掛けるときのようにダイアログに直接入力します。skillIdを指定するか、スキルプロジェクトのルートディレクトリからコマンドを実行し、localeを指定する必要があります。

  • スキルセッションが終了していない場合、User >プロンプトがコマンドラインに引き続き表示されるため、Alexaと会話しているときのようにテキストを入力できます。

  • スキルセッションが終了している場合は---Skill Session Ended.---行がコマンドラインウィンドウに表示されますが、対話モードは開いたままです。User >プロンプトが表示されるので、引き続きテキストを入力できます。

構文

ask dialog [--skill-id | -s <スキルID>]
           [--locale | -l <ロケール>]
           [--stage | -g <ステージ>]
           [--replay | -r <ファイルパス>]

オプション

--skill-id, -s
任意です。amzn1.ask.skill.12345678-1234-1234-123456789123の形式で指定する必要があります。スキルIDまたは--replayオプションを指定していない場合、このコマンドは、スキルが既に作成またはクローンされているルートディレクトリから実行する必要があります。--skill-id--replayの両方のオプションを指定することはできません。
--locale, -l
ASK_DEFAULT_DEVICE_LOCALE環境変数が設定されている場合は任意、--replayオプションが使用されていない場合は必須です。シミュレートするスキルのロケールです。有効な値は、en-USen-GBen-CAen-AUen-INde-DEja-JPです。このオプションも--replayオプションも指定されていない場合、ロケールを入力するようプロンプトが出ます。--replayオプションを使用する場合は、localeを指定できません。
--stage, -g
任意です。スキルのステージを表します。値として、developmentliveのいずれかを使用します。デフォルトはdevelopmentです。
--replay, -r
任意です。スキルとの会話をシミュレートする再生ファイルを指定します。このファイルには、セッションの開始または最後に記録した位置からのテキスト発話が含まれます。記録されたファイルを使用して、よく使われるテストの実行を自動化できます。この再生ファイルには、skill-idlocaleが含まれる場合があります。ファイルにskill-idが含まれていない場合、このコマンドは、テストするスキルが既に作成またはクローンされているスキルプロジェクトのルートディレクトリから実行する必要があります。
--profile, -p
任意です。デフォルト以外のプロファイルを使うには、プロファイル名を指定します。
--debug
任意です。標準エラー出力にデバッグメッセージを追加します。

再生ファイル形式

再生ファイルは以下の形式になります。

{
    "skillId":"amazon.skill.123..",
    "locale": "ja-JP",
    "type": "text",
    "userInput": ["フライトの予約", "バンクーバー"]
}
アトリビュート 説明
skillId シミュレートするスキルのIDです。
locale 「ja-JP」など、スキルをテストするロケールを指定します。
type "text"(テキスト)を指定します。
userInput ユーザーがスキルに話し掛ける発話の配列です。

適切な情報を指定し、以下の形式に従って再生ファイルを手動で作成して、後で利用できるよう保存できます。

再生ファイルは以下の手順でも作成できます。

  • ask dialogコマンドを入力します。
  • プロンプトが出たら、.recordと入力します。
  • プロンプトに従って、必要な情報を入力します。これには、保存するファイル名も含まれます。

どちらの場合にも、--replayオプションを使用するときに使う再生ファイルを指定します。

initコマンド

ask initコマンドは、開発者が新規または既存のAlexaスキルプロジェクトをセットアップするのに役立ちます。このコマンドにより、スキルのデプロイに使用するask-resources.jsonファイルを作成できます。最も一般的なアトリビュートが設定され、エンドポイントとしてAWS Lambdaを使用する場合の目的に合ったデフォルト値を提案します。

構文

ask init [--hosted-skill-id <hostedスキルのID>]
         [--profile | -p <プロファイル>]
         [--debug]

オプション

-hosted-skill-id
任意です。Alexa-hostedスキルのスキルIDを指定すると、現在のディレクトリにスキルのクローンが作成されます。
--profile, -p
任意です。ASK CLIがスキル作成に使用したプロファイルです。指定しない場合、ASK CLIはデフォルトのプロファイルを使用します。

newコマンド

ask newコマンドでは、スキルテンプレートからコピーして新しいスキルプロジェクトを作成できます。コンピューターに新しいAlexaスキルプロジェクトを作成します(最小限の変更でデプロイ先に必要なフォルダやファイルも作成)。概要と使用例については、ASK CLIの概要で新しいスキルプロジェクトを作成するを参照してください。

構文

ask new [--template-url <URL>]
        [--profile | -p <プロファイル>]
        [--debug]
        [--help]

オプション

--template-url
オプション: スキルテンプレートを含むGitリポジトリのURL
--profile, -p
任意です。ASK CLIがスキル作成に使用したプロファイルです。指定しない場合、ASK CLIはデフォルトのプロファイルを使用します。

utilコマンド

utilコマンドは、Alexaスキルの作成を管理するユーティリティツールを提供します。

generate-lwa-tokens

LWAクライアントからLogin with Amazonのトークンを生成します。詳細については、Login with Amazonを参照してください。

構文

ask util generate-lwa-tokens [--profile | -p <プロファイル>]
                             [--client-id]
                             [--client-confirmation]
                             [--scopes]
                             [--no-browser]
                             [--debug]

オプション

--profile, -p
任意です。リクエストのプロファイル。指定しない場合、ASK CLIはデフォルトのプロファイルを使用します。
--client-id
任意です。LWAアプリケーションを登録するときのクライアントID。
--client-confirmation
任意です。LWAアプリケーションを登録するときのクライアントシークレット。
--scopes
任意です。アクセスをリクエストするスコープのリスト(スペース区切り)。
--no-browser
任意です。Amazon開発者アカウントでサインインするための、どこからでも使用できるURLが表示されます。

git-credentials-helper

Alexa-hostedスキルリポジトリのgit認証情報を返します。

構文

ask util git-credentials-helper [--profile | -p <プロファイル>]
                                [--debug]
                                [--help]

オプション

--profile, -p
任意です。ASK CLIがスキルリソースをデプロイするプロファイルです。指定しない場合、ASK CLIはデフォルトのプロファイルを使用します。

upgrade-project

ASK CLI v1.xスキルプロジェクトをASK CLI v2プロジェクト形式にアップグレードします。

構文

ask util upgrade-project [--profile | -p <プロファイル>]
                         [--debug]
                         [--help]

オプション

--profile, -p
任意です。ASK CLIがスキルリソースをデプロイするプロファイルです。指定しない場合、ASK CLIはデフォルトのプロファイルを使用します。

smapiコマンド

smapi コマンドは、Alexaスキル管理API(SMAPI)の基本API操作に1:1でマッピングされたサブコマンドを提供します。これらのコマンドは、API入力を詳細に制御でき、生データを出力します。スキル、音声対話モデル、アカウントリンク情報の作成と更新、スキル認定プロセスの開始を行うサブコマンドがあります。

smapiコマンドとサブコマンドを使用して、開発者アカウントに関連付けられたAlexaスキルの詳細を管理します。Alexaスキルの一部を作成または更新する場合、およびスキルのベータテストを行う場合に、これらのコマンドを使用します。

構文

$ ask smapi <サブコマンド>

add-testers-to-beta-test

テスターを特定のスキルのベータテストに追加します。システムは、各テスターに招待のEメールを送信し、承諾されると参加資格を追加します。

構文

$ ask smapi add-testers-to-beta-test [--skill-id | -s <スキルID>]
                                     [--testers-emails <テスターのEメール>]
                                     [--profile | -p <プロファイル>]
                                     [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--testers-emails
必須です。ベータテストのテスターのEメールアドレスです。[複数可]: 値はコンマで区切ることができます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

associate-isp-with-skill

スキル内商品をスキルに関連付けます。

構文

$ ask smapi associate-isp-with-skill [--product-id <商品ID>]
                                     [--skill-id | -s <スキルID>]
                                     [--profile | -p <プロファイル>]
                                     [--debug]

オプション

--product-id
必須です。スキル内商品のIDです。
--skill-id, -s
必須です。スキルIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

clone-locale

スキルの新しいclone-localeワークフローを作成します。スキルのクローンの詳細については、スキルのロケールをクローンするまたは関連するSMAPI APIリファレンスを参照してください。

構文:

ask smapi clone-locale [-s | --skill-id <スキルID>]
                       [-g | --stage <ステージ>]
                       [--source-locale <ソースロケール>]
                       [--target-locales <ターゲットロケール>]
                       [--overwrite-mode <上書きモード>]
                       [-p | --profile <プロファイル>]
                       [--debug]
                       [-h | --help]

オプション:

-s, --skill-id
必須です。クローンするスキルのスキルIDです。
-g, --stage
必須です。クローンするスキルの公開ステージです。
有効な値:development
--sourceLocale
必須です。複製するスキルのロケール(例:en-US)です。クローンごとに設定できるsourceLocaleは1つだけです。
--targetLocales
必須です。sourceLocaleアセットのコピー先のロケール(例:en-CA)のリストです。コンマ区切りリストを使用すると、1つのコマンドに複数のロケールを含めることができます。
--overwrite-mode
任意です。既存のターゲットにビルドし、現在のロケールを上書きします。
指定できる値: OVERWRITE,DO_NOT_OVERWRITE
デフォルト値: DO_NOT_OVERWRITE
-p, --profile
任意です。ASK CLIがスキルリソースをデプロイするプロファイルです。入力しない場合、ASK CLIはデフォルトのプロファイルを使用します。
--debug
任意です。このオプションを指定すると、ASK CLIはコマンド出力にデバッグメッセージを表示します。

create-beta-test

特定のスキルのベータテストを作成します。

構文

$ ask smapi create-beta-test [--skill-id | -s <スキルID>]
                             [--feedback-email <フィードバックEメール>]
                             [--profile | -p <プロファイル>]
                             [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--feedback-email
任意です。フィードバックを提供するEメールアドレスです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-catalog-upload

カタログの新しいアップロードを作成し、アップロード状態を追跡する場所を返します。

構文

$ ask smapi create-catalog-upload [--catalog-id | -c <カタログID>]
                                  [--catalog-upload-request-body <カタログアップロードリクエスト本文>]
                                  [--profile | -p <プロファイル>]
                                  [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--catalog-upload-request-body
必須です。作成したコンテンツアップロードのリクエスト本文です。[JSON]
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-export-request-for-skill

スキルIDとステージを指定してスキルの新しいエクスポートを作成します。

構文

$ ask smapi create-export-request-for-skill [--skill-id | -s <スキルID>]
                                            [--stage | -g <ステージ>]
                                            [--profile | -p <プロファイル>]
                                            [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-interaction-model-catalog

新しいカタログを作成します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi create-interaction-model-catalog [--catalog-name <カタログ名>]
                                             [--catalog-description <カタログの説明>]
                                             [--vendor-id <ベンダーID>]
                                             [--profile | -p <プロファイル>]
                                             [--debug]

オプション

--catalog-name
任意です。カタログの名前です。
--catalog-description
任意です。カタログの説明文字列です。
--vendor-id
必須です。カタログが属するベンダーのIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-interaction-model-catalog-version

指定したcatalogIdの新しいカタログバージョンを作成します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi create-interaction-model-catalog-version [--catalog-id | -c <カタログID>]
                                                     [--source-type <ソースの種類>]
                                                     [-source-url <ソースのURL>]
                                                     [--description <説明>]
                                                     [--profile | -p <プロファイル>]
                                                     [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--source-type
任意です。カタログの種類です。
--source-url
任意です。参照するカタログのURLです。
--description
必須です。特定のカタログバージョンの説明文字列です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-interaction-model-slot-type

指定したslotTypeId内に新しいスロットタイプバージョンを作成します。

構文

$ ask smapi create-interaction-model-slot-type [--slot-type <スロットタイプ>]
                                               [--profile | -p <プロファイル>]
                                               [--debug]

オプション

--slot-type
必須です。[JSON]
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-interaction-model-slot-type-version

指定したslotTypeIdの新しいスロットタイプエンティティバージョンを作成します。

構文

$ ask smapi create-interaction-model-slot-type-version [--slot-type-id <スロットタイプID>]
                                                       [--slot-type <スロットタイプ>]
                                                       [--profile | -p <プロファイル>]
                                                       [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--slot-type
必須です。[JSON]
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-isp-for-vendor

指定されたベンダーIDで新しいスキル内商品を作成します。

構文

$ ask smapi create-isp-for-vendor [--create-in-skill-product-request <スキル内商品作成リクエスト>]
                                  [--profile | -p <プロファイル>]
                                  [--debug]

オプション

--create-in-skill-product-request
必須です。createInSkillProduct APIのリクエスト本文です。[JSON]
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-skill-for-vendor

指定されたベンダーIDで新しいスキルを作成します。

構文

$ ask smapi create-skill-for-vendor [--manifest <マニフェスト>]
                                    [--profile | -p <プロファイル>]
                                    [--debug]

オプション

--manifest
必須です。createSkill APIのリクエスト本文を定義します。[JSON]
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-skill-package

スキルの新しいインポートを作成します。

構文

$ ask smapi create-skill-package [--vendor-id <ベンダーID>]
                                 [--location <場所>]
                                 [--profile | -p <プロファイル>]
                                 [--debug]

オプション

--vendor-id
必須です。スキルを所有しているベンダーのIDです。
--location
必須です。パッケージの場所です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

create-upload-url

新しいアップロードURLを作成します。

構文

$ ask smapi create-upload-url [--profile | -p <プロファイル>]
                              [--debug]

オプション

--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-account-linking-info

スキルの特定のステージのアカウントリンク情報を削除します。

構文

$ ask smapi delete-account-linking-info [--skill-id | -s <スキルID>]
                                        [--stage | -g <ステージ>]
                                        [--profile | -p <プロファイル>]
                                        [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-interaction-model-catalog

カタログを削除します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi delete-interaction-model-catalog [--catalog-id | -c <カタログID>]
                                             [--profile | -p <プロファイル>]
                                             [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-interaction-model-catalog-version

カタログのバージョンを削除します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi delete-interaction-model-catalog-version [--catalog-id | -c <カタログID>]
                                                     [--version <バージョン>]
                                                     [--profile | -p <プロファイル>]
                                                     [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--version
必須です。音声対話モデルのバージョンです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-interaction-model-slot-type

スロットタイプを削除します。

構文

$ ask smapi delete-interaction-model-slot-type [--slot-type-id <スロットタイプID>]
                                               [--profile | -p <プロファイル>]
                                               [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-interaction-model-slot-type-version

スロットタイプのバージョンを削除します。

構文

$ ask smapi delete-interaction-model-slot-type-version [--slot-type-id <スロットタイプID>]
                                                       [--version <バージョン>]
                                                       [--profile | -p <プロファイル>]
                                                       [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--version
必須です。音声対話モデルのバージョンです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-isp-for-product

指定されたproductIdのスキル内商品を削除します。開発ステージのみサポートされています。公開中のスキル内商品、またはスキルに関連付けられたスキル内商品は、このAPIでは削除できません。

構文

$ ask smapi delete-isp-for-product [--product-id <商品ID>]
                                   [--stage | -g <ステージ>]
                                   [--if-match <一致>]
                                   [--profile | -p <プロファイル>]
                                   [--debug]

オプション

--product-id
必須です。スキル内商品のIDです。
--stage、-g
必須です。スキルのステージ。
--if-match
任意です。エンティティタグを指定したリクエストヘッダーです。サーバーは、eTagがリソースの現在のeTagと一致した場合にのみリソースを更新します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-private-distribution-account-id

非公開の配信アカウントからIDを削除します。

構文

$ ask smapi delete-private-distribution-account-id [--skill-id | -s <スキルID>]
                                                   [--stage | -g <ステージ>]
                                                   [--id <id>]
                                                   [--profile | -p <プロファイル>]
                                                   [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--id
必須です。スキルを非公開で配信できるARNです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-skill

指定されたskillIdのスキルとモデルを削除します。

構文

$ ask smapi delete-skill [--skill-id | -s <スキルID>]
                         [--profile | -p <プロファイル>]
                         [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

delete-skill-enablement

指定したskillId/stageとcustomerId(Authトークンにより取得)の有効化ステータスを削除します。

構文

$ ask smapi delete-skill-enablement [--skill-id | -s <スキルID>]
                                    [--stage | -g <ステージ>]
                                    [--profile | -p <プロファイル>]
                                    [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

disassociate-isp-with-skill

スキル内商品とスキルの関連付けを解除します。

構文

$ ask smapi disassociate-isp-with-skill [--product-id <商品ID>]
                                        [--skill-id | -s <スキルID>]
                                        [--profile | -p <プロファイル>]
                                        [--debug]

オプション

--product-id
必須です。スキル内商品のIDです。
--skill-id, -s
必須です。スキルIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

end-beta-test

特定のスキルのベータテストを終了します。システムは各テスターの参加資格を取り消し、テスターにアクセス終了の通知メールを送信します。

構文

$ ask smapi end-beta-test [--skill-id | -s <スキルID>]
                          [--profile | -p <プロファイル>]
                          [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

export-package

スキルパッケージを現在のディレクトリのskill-packageフォルダにダウンロードします。

構文

$ ask smapi export-package [--skill-id | -s <スキルID>]
                           [--stage | -g <ステージ>]
                           [--profile | -p <プロファイル>]
                           [--debug]

オプション

--skill-id, -s
必須です。スキルID。
--stage、-g
必須です。スキルのステージです。
--profile, -p
任意です。使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
任意です。このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

generate-catalog-upload-url

データをアップロードするための署名付きURLを生成します。

構文

$ ask smapi generate-catalog-upload-url [--catalog-id | -c <カタログID>]
                                        [--number-of-upload-parts <アップロードパートの数>]
                                        [--profile | -p <プロファイル>]
                                        [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--number-of-upload-parts
必須です。部分ファイルの数です。各部分ファイルをアップロードするために、同数の署名付きURLが生成されます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

generate-credentials-for-alexa-hosted-skill

Alexa-hostedスキルのリポジトリにアクセスするための認証情報を生成します。

構文

$ ask smapi generate-credentials-for-alexa-hosted-skill [--skill-id | -s <スキルID>]
                                                        [--repository-url <リポジトリURL>]
                                                        [--repository-type <リポジトリの種類>]
                                                        [--profile | -p <プロファイル>]
                                                        [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--repository-url
任意です。Alexa-hostedスキルのリポジトリのURLです。
--repository-type
任意です。Alexa-hostedスキルのリポジトリの種類です。[列挙]: GIT
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-account-linking-info

スキルのアカウントリンク情報を取得します。

構文

$ ask smapi get-account-linking-info [--skill-id | -s <スキルID>]
                                     [--stage | -g <ステージ>]
                                     [--profile | -p <プロファイル>]
                                     [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-alexa-hosted-skill-metadata

Alexa-hostedスキルのメタデータを取得します。

構文

$ ask smapi get-alexa-hosted-skill-metadata [--skill-id | -s <スキルID>]
                                            [--profile | -p <プロファイル>]
                                            [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-alexa-hosted-skill-user-permissions

Alexa-hostedスキル機能への現在のユーザーのアクセス権限を取得します。

構文

$ ask smapi get-alexa-hosted-skill-user-permissions [--permission <権限>]
                                                    [--profile | -p <プロファイル>]
                                                    [--debug]

オプション

--permission
必須です。ユーザーがチェックする必要のあるAlexa-hostedスキル機能の権限です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-beta-test

特定のスキルのベータテストを取得します。

構文

$ ask smapi get-beta-test [--skill-id | -s <スキルID>]
                          [--profile | -p <プロファイル>]
                          [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-certification-review

特定の認定リソースを取得します。応答には、Amazonによる審査終了までにかかる予想残り時間を示すスキル審査の追跡情報が含まれます。審査が完了すると、応答には審査結果も入ります。古い認定については取得できない場合もありますが、継続中の認定には常に応答を返します。認定情報が取得できない場合、結果にはHTTPステータスコード404が返されます。

構文

$ ask smapi get-certification-review [--accept-language <言語>]
                                     [--skill-id | -s <スキルID>]
                                     [--certification-id | -c <認定ID>]
                                     [--profile | -p <プロファイル>]
                                     [--debug]

オプション

--accept-language
任意です。コンテキスト内のユーザーのロケールまたは言語です。
--skill-id, -s
必須です。スキルIDです。
--certification-id, -c
必須です。認定のIDです。IDの予約語であるmostRecentを使って最新のスキル認定を取得できます。この場合のAPI動作は、リクエストで実際に指定されたIDが最新の認定IDだった場合と同様です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-certifications-list

過去の認定や現在有効な認定など、スキルで利用可能なすべての認定のリストを取得します。デフォルトの並べ替え順序は、認定のskillSubmissionTimestampの新しい順です。

構文

$ ask smapi get-certifications-list [--skill-id | -s <スキルID>]
                                    [--next-token <次のトークン>]
                                    [--max-results <結果の最大件数>]
                                    [--profile | -p <プロファイル>]
                                    [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-clone-locale-status

進行中のclone-localeワークフローのステータスを返します。スキルのクローンの詳細については、スキルのロケールをクローンするまたは関連するSMAPI APIリファレンスを参照してください。

構文:

ask smapi get-clone-locale-status [-s,--skill-id <スキルID>]
                                  [-g | --stage <ステージ>]
                                  [-clone-locale-request-id <clone-localeリクエストID>]
                                  [-p | --profile <プロファイル>]
                                  [--debug]
                                  [-h | --help]

オプション:

-s, --skill-id
必須です。クローンするスキルのスキルIDです。
-g, --stage
必須です。クローンするスキルの公開ステージです。
有効な値:development
--clone-locale-request-id
必須です。clone-localeワークフローのIDを定義します。~latestに設定すると、リクエストは最新のclone-localeワークフローのステータスを返します。
-p, --profile
任意です。ASK CLIがスキルリソースをデプロイするプロファイルです。入力しない場合、ASK CLIはデフォルトのプロファイルを使用します。
--debug
任意です。このオプションを指定すると、ASK CLIはコマンド出力にデバッグメッセージを表示します。

get-content-upload-by-id

特定のカタログの特定のアップロードに関する情報を取得します。アップロードの取り込みステップとファイルダウンロードのURLを含みます。

構文

$ ask smapi get-content-upload-by-id [--catalog-id | -c <カタログID>]
                                     [--upload-id <アップロードID>]
                                     [--profile | -p <プロファイル>]
                                     [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--upload-id
必須です。一意のアップロードIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-import-status

指定されたimportIdのステータスを取得します。

構文

$ ask smapi get-import-status [--import-id <インポートID>]
                              [--profile | -p <プロファイル>]
                              [--debug]

オプション

--import-id
必須です。インポートIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model

特定のステージのスキルの音声対話モデルを取得します。

構文

$ ask smapi get-interaction-model [--skill-id | -s <スキルID>]
                                  [--stage | -g <ステージ>]
                                  [--locale | -l <ロケール>]
                                  [--profile | -p <プロファイル>]
                                  [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--locale, -l
必須です。リクエストするモデルのロケールです。例:ja-JP、en-US、de-DEなど。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-catalog-definition

カタログ定義を取得します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi get-interaction-model-catalog-definition [--catalog-id | -c <カタログID>]
                                                     [--profile | -p <プロファイル>]
                                                     [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-catalog-update-status

カタログを作成または更新するための以前のリクエストのステータスを取得します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi get-interaction-model-catalog-update-status [--catalog-id | -c <カタログID>]
                                                        [--update-request-id <更新リクエストID>]
                                                        [--profile | -p <プロファイル>]
                                                        [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--update-request-id
必須です。スロットタイプバージョンの作成プロセスのIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-catalog-values

指定された対話モデルカタログとバージョンから値を取得します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi get-interaction-model-catalog-values [--catalog-id | -c <カタログID>]
                                                 [--version <バージョン>]
                                                 [--max-results <結果の最大件数>]
                                                 [--next-token <次のトークン>]
                                                 [--profile | -p <プロファイル>]
                                                 [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--version
必須です。音声対話モデルのバージョンです。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-catalog-version

カタログの特定のバージョンを取得します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi get-interaction-model-catalog-version [--catalog-id | -c <カタログID>]
                                                  [--version <バージョン>]
                                                  [--profile | -p <プロファイル>]
                                                  [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--version
必須です。音声対話モデルのバージョンです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-metadata

指定したステージの音声対話モデルの最新メタデータを取得します。

構文

$ ask smapi get-interaction-model-metadata [--skill-id | -s <スキルID>]
                                           [--stage | -g <ステージ>]
                                           [--locale | -l <ロケール>]
                                           [--profile | -p <プロファイル>]
                                           [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--locale, -l
必須です。リクエストするモデルのロケールです。例:ja-JP、en-US、de-DEなど。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-slot-type-build-status

指定したslotTypeIdのスロットタイプリソースとそのサブリソースのステータスを取得します。

構文

$ ask smapi get-interaction-model-slot-type-build-status [--slot-type-id <スロットタイプID>]
                                                         [--update-request-id <更新リクエストID>]
                                                         [--profile | -p <プロファイル>]
                                                         [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--update-request-id
必須です。slotTypeバージョンの作成プロセスのIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-slot-type-definition

スロットタイプ定義を取得します。

構文

$ ask smapi get-interaction-model-slot-type-definition [--slot-type-id <スロットタイプID>]
                                                       [--profile | -p <プロファイル>]
                                                       [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-slot-type-version

スロットタイプバージョンを指定してスロットタイプバージョンのデータを取得します。

構文

$ ask smapi get-interaction-model-slot-type-version [--slot-type-id <スロットタイプID>]
                                                    [--version <バージョン>]
                                                    [--profile | -p <プロファイル>]
                                                    [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--version
必須です。音声対話モデルのバージョンです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-interaction-model-version

スキルの指定したバージョンの音声対話モデルを取得します。

構文

$ ask smapi get-interaction-model-version [--skill-id | -s <スキルID>]
                                          [--stage | -g <ステージ>]
                                          [--locale | -l <ロケール>]
                                          [--version <バージョン>]
                                          [--profile | -p <プロファイル>]
                                          [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--locale, -l
必須です。リクエストするモデルのロケールです。例:ja-JP、en-US、de-DEなど。
--version
必須です。取得する音声対話モデルのバージョンです。現在のバージョンの音声対話モデルを取得するには、~currentを使用します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-isp-associated-skills

スキル内商品に関連付けられたスキルを取得します。

構文

$ ask smapi get-isp-associated-skills [--product-id <商品ID>]
                                      [--stage | -g <ステージ>]
                                      [--next-token <次のトークン>]
                                      [--max-results <結果の最大件数>]
                                      [--profile | -p <プロファイル>]
                                      [--debug]

オプション

--product-id
必須です。スキル内商品のIDです。
--stage、-g
必須です。スキルのステージ。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-isp-definition

指定された商品IDのスキル内商品の定義を返します。

構文

$ ask smapi get-isp-definition [--product-id <商品ID>]
                               [--stage | -g <ステージ>]
                               [--profile | -p <プロファイル>]
                               [--debug]

オプション

--product-id
必須です。スキル内商品のIDです。
--stage、-g
必須です。スキルのステージ。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-isp-list-for-skill-id

スキルIDのスキル内商品のリストを取得します。

構文

$ ask smapi get-isp-list-for-skill-id [--skill-id | -s <スキルID>]
                                      [--stage | -g <ステージ>]
                                      [--next-token <次のトークン>]
                                      [--max-results <結果の最大件数>]
                                      [--profile | -p <プロファイル>]
                                      [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-isp-list-for-vendor

ベンダーのスキル内商品のリストを取得します。

構文

$ask smapi get-isp-list-for-vendor[-next-token<次のトークン>]
                                    [--max-results <結果の最大件数>]
                                    [--product-id <商品ID>]
                                    [--stage | -g <ステージ>]
                                    [--type <タイプ>]
                                    [--reference-name <参照名>]
                                    [--status <ステータス>]
                                    [--is-associated-with-skill <スキルとの関連付け>]
                                    [--profile | -p <プロファイル>]
                                    [--debug]

オプション

--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--product-id
任意です。概要を取得するスキル内商品のIDのリストです。1つのlistInSkillProducts呼び出しで、最大50個のスキル内商品IDを指定できます。このパラメーターは'nextToken'パラメーターと'maxResults'パラメーターの両方またはいずれかと共に使用する必要があります。[複数可]: 値はコンマで区切ることができます。
--stage, -g
任意です。スキル内商品を指定したステージでフィルタリングします。[列挙]:development,live
--type
任意です。フィルタリングするスキル内商品のタイプです。[列挙]: SUBSCRIPTION,ENTITLEMENT,CONSUMABLE
--reference-name
任意です。スキル内商品を参照名でフィルタリングします。
--status
任意です。スキル内商品のステータスです。[列挙]: INCOMPLETE,COMPLETE,CERTIFICATION,PUBLISHED,SUPPRESSED
--is-associated-with-skill
任意です。スキル内商品を、スキルに関連付けられているかどうかでフィルタリングします。[列挙]: ASSOCIATED_WITH_SKILL,NO_SKILL_ASSOCIATIONS
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-isp-summary

スキル内商品の概要を取得します。

構文

$ ask smapi get-isp-summary [--product-id <商品ID>]
                            [--stage | -g <ステージ>]
                            [--profile | -p <プロファイル>]
                            [--debug]

オプション

--product-id
必須です。スキル内商品のIDです。
--stage、-g
必須です。スキルのステージ。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-list-of-testers

特定のAlexaスキルのベータテストに参加しているテスターをすべて表示します。

構文

$ ask smapi get-list-of-testers [--skill-id | -s <スキルID>]
                                [--next-token <次のトークン>]
                                [--max-results <結果の最大件数>]
                                [--profile | -p <プロファイル>]
                                [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-skill-enablement-status

指定したskillId/stageとcustomerId(Authトークンにより取得)の有効化ステータスが存在するかどうかを確認します。

構文

$ ask smapi get-skill-enablement-status [--skill-id | -s <スキルID>]
                                        [--stage | -g <ステージ>]
                                        [--profile | -p <プロファイル>]
                                        [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-skill-manifest

指定したskillIdとステージのスキルマニフェストを返します。

構文

$ ask smapi get-skill-manifest [--skill-id | -s <スキルID>]
                               [--stage | -g <ステージ>]
                               [--profile | -p <プロファイル>]
                               [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-skill-metrics

スキル使用状況の分析指標レポートを取得します。

構文

$ ask smapi get-skill-metrics [--skill-id | -s <スキルID>]
                              [--start-time <開始時刻>]
                              [--end-time <終了時刻>]
                              [--period <期間>]
                              [--metric <メトリック>]
                              [--stage | -g <ステージ>]
                              [--skill-type <スキルの種類>]
                              [--intent <インテント>]
                              [--locale | -l <ロケール>]
                              [--max-results <結果の最大件数>]
                              [--next-token <次のトークン>]
                              [--profile | -p <プロファイル>]
                              [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--start-time
必須です。クエリの開始時刻です。
--end-time
必須です。クエリの終了時刻です(最大期間は1週間です)。
--period
必須です。測定基準を取得する際に使用する集計期間は、ISO_8601の継続時間の形式に従います。
--metric
必須です。定期的にデータセットを返す別個のロジックのセットです。
--stage、-g
必須です。スキルのステージです(live、development)。
--skill-type
必須です。スキルの種類です(custom、smartHome、flashBriefing)。
--intent
任意です。スキルのインテントです。
--locale, -l
任意です。スキルのロケールです。例:ja-JP、en-US、de-DEなど。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-skill-simulation

このAPIは、以前に実行したシミュレーションの結果を取得します。成功した場合の応答には、実行したシミュレーションのステータスが含まれます。シミュレーションが成功した場合、応答にはスキルの呼び出しに関連する情報が含まれます。このAPIへのリクエストがエラーになった場合、応答にはエラーコードと問題の詳細が含まれます。シミュレーションが失敗した場合、応答にはエラーの発生とスキルエンドポイントに何が送信されたかの詳細を示すステータスアトリビュートが入ります。シミュレーション結果は、10分間保存されます。期限切れのシミュレーション結果をリクエストすると、404のHTTPステータスコードが返されます。

構文

$ ask smapi get-skill-simulation [--skill-id | -s <スキルID>]
                                 [--stage | -g <ステージ>]
                                 [--simulation-id | -i <シミュレーションID>]
                                 [--profile | -p <プロファイル>]
                                 [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--simulation-id, -i
必須です。シミュレーションのIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-skill-status

指定したskillIdのスキルリソースとそのサブリソースのステータスを取得します。

構文

$ ask smapi get-skill-status [--skill-id | -s <スキルID>]
                             [--resource <リソース>]
                             [--profile | -p <プロファイル>]
                             [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--resource
任意です。ステータス情報を取得するリソース名です。任意のフィルタリングパラメーターであり、1回のAPI呼び出しでパラメーターを複数回使用してすべてのリソースまたはサブリソース(指定したもののみ)のステータスを取得できます。このパラメーターを指定しない場合、すべてのリソースとサブリソースのステータスが返されます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-skill-validations

このAPIは、以前に実行した検証の結果を取得します。成功した場合の応答には、実行した検証のステータスが含まれます。検証が成功すると、応答には実行した検証に関連する情報が含まれます。このAPIへのリクエストがエラーになった場合、応答に問題の詳細が記述されています。検証が失敗した場合、応答にはエラーの発生を示すステータスアトリビュートが入ります。検証結果は、60分間保存されます。期限切れの検証結果をリクエストすると、404のHTTPステータスコードが返されます。

構文

$ ask smapi get-skill-validations [--skill-id | -s <スキルID>]
                                  [--validation-id | -i  <検証ID>]
                                  [--stage | -g <ステージ>]
                                  [--accept-language <言語>]
                                  [--profile | -p <プロファイル>]
                                  [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--validation-id, -i
必須です。検証のIDです。IDの予約語であるmostRecentを使って最新のスキルとステージの検証を取得できます。この場合のAPI動作は、リクエストで実際に指定されたIDが最新の検証IDだった場合と同様です。
--stage、-g
必須です。スキルのステージ。
--accept-language
任意です。コンテキスト内のユーザーのロケールまたは言語です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-ssl-certificates

このスキルに現在関連付けられているSSL証明書セットを返します。セットは、リージョンに関連付けられた1つのSSL証明書BLOBと、スキルのデフォルトの証明書で構成されます。

構文

$ ask smapi get-ssl-certificates [--skill-id | -s <スキルID>]
                                 [--profile | -p <プロファイル>]
                                 [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-status-of-export-request

指定されたexportIdのステータスを取得します。

構文

$ ask smapi get-status-of-export-request [--export-id <エクスポートID>]
                                         [--profile | -p <プロファイル>]
                                         [--debug]

オプション

--export-id
必須です。エクスポートIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-task

指定されたタスク名とバージョンのタスク定義の詳細を取得します。

構文

$ ask smapi get-task [--skill-id | -s <スキルID>]
                     [--task-name <タスク名>]
                     [--task-version <タスクのバージョン>]
                     [--profile | -p <プロファイル>]
                     [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--task-name
必須です。タスク名です。
--task-version
必須です。タスクのバージョンです。「1」などを指定します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-utterance-data

構文

$ ask smapi get-utterance-data [--skill-id | -s <スキルID>]
                               [--next-token <次のトークン>]
                               [--max-results <結果の最大件数>]
                               [--sort-direction <並べ替え順序>]
                               [--sort-field <並べ替えフィールド>]
                               [--stage | -g <ステージ>]
                               [--locale | -l <ロケール>]
                               [--dialog-act-name <ダイアログアクション名>]
                               [--intent-confidence-bin <インテント信頼度>]
                               [-intent-name <インテント名>]
                               [-intent-slots-name <インテントスロット名>]
                               [-interaction-type <対話タイプ>]
                               [-publication-status <公開ステータス>]
                               [-utterance-text <発話テキスト>]
                               [--profile | -p <プロファイル>]
                               [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--sort-direction
任意です。リスト項目の並べ替え順序を設定します。'asc'を設定すると、項目はsortField値の昇順で返され、'desc'を設定すると、項目はsortField値の降順で返されます。
--sort-field
任意です。並べ替えの基準とするフィールドを設定します。
--stage, -g
任意です。指定した値と同じステージの項目取得に使用するフィルターです。[複数可]: 値はコンマで区切ることができます。[列挙]:development,live
--locale, -l
任意です。指定した値と同じロケールの項目取得に使用するフィルターです。[複数可]: 値はコンマで区切ることができます。[列挙]:en-US,en-GB,en-IN,en-CA,en-AU,de-DE,ja-JP
--dialog-act-name
任意です。ダイアログアクションディレクティブの名前です。* Dialog.ElicitSlot: Alexaはユーザーに特定のスロットの値を求めました。詳細については、ElicitSlotディレクティブを参照してください。* Dialog.ConfirmSlot: Alexaはダイアログを続行する前に特定のスロットの値を確認しました。詳細については、ConfirmSlotディレクティブを参照してください。* Dialog.ConfirmIntent: Alexaは、スキルでアクションを実行する前に、ユーザーがインテントに提供したすべての情報をユーザーに確認しました。詳細については、ConfirmIntentディレクティブを参照してください。[複数可]: 値はコンマで区切ることができます。[列挙]: Dialog.ElicitSlot,Dialog.ConfirmSlot,Dialog.ConfirmIntent
--intent-confidence-bin
任意です。指定した値と同じインテント信頼度の項目取得に使用するフィルターです。*'HIGH': インテントが高信頼度と認識された場合。*'MEDIUM': インテントが中信頼度を認識された場合。*'LOW': インテントが低信頼度と認識された場合。低信頼度のインテントはスキルに送信されません。[複数可]: 値はコンマで区切ることができます。[列挙]: HIGH,MEDIUM,LOW
--intent-name
任意です。指定した値と同じインテント名の項目取得に使用するフィルターです。[複数可]: 値はコンマで区切ることができます。
--intent-slots-name
任意です。指定したいずれかの値と同じスロット名の項目取得に使用するフィルターです。[複数可]: 値はコンマで区切ることができます。
--interaction-type
任意です。対話が"ONE_SHOT"対話として実行されたのか、"MODAL"対話として実行されたのかを表します。* `ONE_SHOT`: ユーザーはスキルを呼び出しとインテントのリクエストを単一のフレーズで伝えます。* `MODAL`: ユーザーは最初にスキルを呼び出してからインテントを伝えます。[複数可]: 値はコンマで区切ることができます。[列挙]: ONE_SHOT,MODAL
--publication-status
任意です。この対話が発生したときのスキルの公開ステータスです。[複数可]: 値はコンマで区切ることができます。[列挙]: Development,Certification
--utterance-text
任意です。発話テキストに特定のフレーズを含む項目の取得に使用されるフィルターです。各フィルターの値は1~100文字で指定できます。[複数可]: 値はコンマで区切ることができます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

get-vendor-list

ベンダー情報のリストを取得します。

構文

$ ask smapi get-vendor-list [--profile | -p <プロファイル>]
                            [--debug]

オプション

--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

import-skill-package

指定されたスキルIDでスキルの新しいインポートを作成します。

構文

$ ask smapi import-skill-package [--location <場所>]
                                 [--skill-id | -s <スキルID>]
                                 [--if-match <一致>]
                                 [--profile | -p <プロファイル>]
                                 [--debug]

オプション

--location
必須です。パッケージの場所です。
--skill-id, -s
必須です。スキルIDです。
--if-match
任意です。エンティティタグを指定したリクエストヘッダーです。サーバーは、eTagがリソースの現在のeTagと一致した場合にのみリソースを更新します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

invoke-skill

これは、スキルのLambda(またはサードパーティのHTTPS)エンドポイントを呼び出す同期APIです。応答には、呼び出されたエンドポイントと、エンドポイントとの間で送受信されたペイロードの情報が含まれます。invoke-skillを呼び出すことができるのは、開発者自身が所有している有効なスキルだけです。

スキルエンドポイントでエラーが発生した場合、応答には失敗のステータスアトリビュートとエンドポイントに送信された内容の詳細が含まれます。invoke-skillでエラーが発生した場合、応答にはエラーコードと問題の詳細が含まれます。

スキルエンドポイントへの呼び出しは、10秒後にタイムアウトします。このAPIは、より長いタイムアウトが必要な場合に非同期APIに拡張できるように設計されています。

構文

$ ask smapi invoke-skill [--skill-id | -s <スキルID>]
                         [--endpoint-region <エンドポイントのリージョン>]
                         [--skill-request-body <スキルリクエスト本文>]
                         [--full-response]
                         [--profile | -p <プロファイル>]
                         [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--endpoint-region
必須です。エンドポイントを呼び出すリージョン。次のいずれかになります。 NAEUFE
--skill-request-body
必須です。リクエスト本文のJSONです。JSONは文字列として、またはファイルで指定できます。ファイルを指定する場合は、絶対パスまたは相対パスで指定できます。たとえば、"$(cat {filepath})""file:{filepath}"のように指定します。
--full-response
このオプションを含めると、応答の本文、ヘッダー、ステータスコードが1つのオブジェクトとして返されます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

invoke-skill-end-point

これは、スキルのLambda(またはサードパーティのHTTPS)エンドポイントを呼び出す同期APIです。応答には、呼び出されたエンドポイントと、エンドポイントとの間で送受信されたペイロードの情報が含まれます。invoke-skillを呼び出すことができるのは、開発者自身が所有している有効なスキルだけです。

スキルエンドポイントでエラーが発生した場合、応答には失敗のステータスアトリビュートとエンドポイントに送信された内容の詳細が含まれます。invoke-skillでエラーが発生した場合、応答にはエラーコードと問題の詳細が含まれます。

スキルエンドポイントへの呼び出しは、10秒後にタイムアウトします。このAPIは、より長いタイムアウトが必要な場合に非同期APIに拡張できるように設計されています。

構文

$ ask smapi invoke-skill-end-point [--skill-id | -s <スキルID>]
                                   [--stage | -g <ステージ>]
                                   [--endpoint-region <エンドポイントのリージョン>]
                                   [--skill-request-body <スキルリクエスト本文>]
                                   [--profile | -p <プロファイル>]
                                   [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージです。developmentliveのいずれかです。
--endpoint-region
必須です。エンドポイントを呼び出すリージョン。次のいずれかになります: NA, EU, FE.
--skill-request-body
必須です。リクエスト本文のJSONです。JSONは文字列として、またはファイルで指定できます。ファイルを指定する場合は、絶対パスまたは相対パスを使用して指定できます。たとえば、"$(cat {filepath})""file:{filepath}"のように指定します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

list-interaction-model-catalogs

すべてのカタログのリストを取得します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi list-interaction-model-catalogs [--max-results <結果の最大件数>]
                                            [--next-token <次のトークン>]
                                            [--sort-direction <並べ替え順序>]
                                            [--profile | -p <プロファイル>]
                                            [--debug]

オプション

--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--sort-direction
任意です。リスト項目の並べ替え順序を設定します。'asc'を設定すると、項目はsortField値の昇順で返され、'desc'を設定すると、項目はsortField値の降順で返されます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

list-interaction-model-versions

カタログのバージョンのリストを取得します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi list-interaction-model-versions [--skill-id | -s <スキルID>]
                                            [--stage | -g <ステージ>]
                                            [--locale | -l <ロケール>]
                                            [--next-token <次のトークン>]
                                            [--max-results <結果の最大件数>]
                                            [--sort-direction <並べ替え順序>]
                                            [--sort-field <並べ替えフィールド>]
                                            [--profile | -p <プロファイル>]
                                            [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--locale, -l
必須です。リクエストするモデルのロケールです。例:ja-JP、en-US、de-DEなど。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--sort-direction
任意です。リスト項目の並べ替え順序を設定します。'asc'を設定すると、項目はsortField値の昇順で返され、'desc'を設定すると、項目はsortField値の降順で返されます。
--sort-field
任意です。並べ替えの基準とするフィールドを設定します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

list-interaction-model-slot-types

ベンダーのすべてのスロットタイプのリストを取得します。

構文

$ ask smapi list-interaction-model-slot-types [--max-results <結果の最大件数>]
                                              [--next-token <次のトークン>]
                                              [--sort-direction <並べ替え順序>]
                                              [--profile | -p <プロファイル>]
                                              [--debug]

オプション

--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--sort-direction
任意です。リスト項目の並べ替え順序を設定します。'asc'を設定すると、項目はsortField値の昇順で返され、'desc'を設定すると、項目はsortField値の降順で返されます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

list-interaction-model-slot-type-versions

指定したslotTypeIdのすべてのスロットタイプバージョンのリストを取得します。

構文

$ ask smapi list-interaction-model-slot-type-versions [--slot-type-id <スロットタイプID>]
                                                      [--max-results <結果の最大件数>]
                                                      [--next-token <次のトークン>]
                                                      [--sort-direction <並べ替え順序>]
                                                      [--profile | -p <プロファイル>]
                                                      [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--sort-direction
任意です。リスト項目の並べ替え順序を設定します。'asc'を設定すると、項目はsortField値の昇順で返され、'desc'を設定すると、項目はsortField値の降順で返されます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

list-private-distribution-accounts

非公開の配信アカウントのリストを表示します。

構文

$ ask smapi list-private-distribution-accounts [--skill-id | -s <スキルID>]
                                               [--stage | -g <ステージ>]
                                               [--next-token <次のトークン>]
                                               [--max-results <結果の最大件数>]
                                               [--profile | -p <プロファイル>]
                                               [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

list-skills-for-vendor

ベンダーのスキルリストを取得します。

構文

$ ask smapi list-skills-for-vendor [--next-token <次のトークン>]
                                   [--max-results <結果の最大件数>]
                                   [--skill-id | -s <スキルID>]
                                   [--profile | -p <プロファイル>]
                                   [--debug]

オプション

--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--skill-id, -s
任意です。概要を取得するスキルIDのリストです。1回のlistSkills呼び出しで、スキルIDを最大10個まで指定してスキルの概要を取得できます。このパラメーターは'nextToken'、'maxResults'パラメーターのいずれかまたは両方と共に使用する必要があります。[複数可]: 値はコンマで区切ることができます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

profile-nlu

音声対話モデルに対して発話をプロファイルします。

構文

$ ask smapi profile-nlu [--utterance | -u <発話>]
                        [--multi-turn-token <マルチターントークン>]
                        [--skill-id | -s <スキルID>]
                        [--stage | -g <ステージ>]
                        [--locale | -l <ロケール>]
                        [--profile | -p <プロファイル>]
                        [--debug]

オプション

--utterance, -u
必須です。Alexaに対してユーザーが実際に話しかける内容です。
--multi-turn-token
必須です。マルチターン関連のコンテキストを含むOpaque文字列です。
--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--locale, -l
必須です。リクエストするモデルのロケールです。例:ja-JP、en-US、de-DEなど。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

query-development-audit-logs

SMAPI監査ログAPIは、そのアカウントに対する権限を持った開発者(複数可)によって呼び出されたすべてのSMAPI呼び出しの監査履歴をユーザーに提供します。

構文

$ ask smapi query-development-audit-logs [--vendor-id <ベンダーID>]
                                         [--request-filters-clients <クライアントリクエストフィルター>]
                                         [--request-filters-operations <操作リクエストフィルター>]
                                         [--request-filters-resources <リソースリクエストフィルター>]
                                         [--request-filters-requesters <リクエスターリクエストフィルター>]
                                         [--request-filters-start-time <開始時刻リクエストフィルター>]
                                         [--request-filters-end-time <終了時刻リクエストフィルター>]
                                         [--request-filters-http-response-codes <HTTP応答コードリクエストフィルター>]
                                         [--sort-direction <並べ替え順序>]
                                         [--sort-field <並べ替えフィールド>]
                                         [--pagination-context-next-token <ページ分割コンテキストの次のトークン>]
                                         [--pagination-context-max-results <ページ分割コンテキストの最大件数>]
                                         [--profile | -p <プロファイル>]
                                         [--debug]

オプション

--vendor-id
必須です。ベンダーIDです。カスタマーIDとベンダーIDを参照してください。
--request-filters-clients
任意です。フィルタリングするクライアントIDのリストです。
--request-filters-operations
任意です。操作名とバージョンリストのフィルターです。
--request-filters-resources
任意です。リソース、リソースの種類のいずれかまたは両方のリストのフィルターです。利用可能な種類については、ドキュメントを参照してください。
--request-filters-requesters
任意です。監査ログをフィルタリングするリクエストフィルターです。
--request-filters-start-time
任意です。この検索の開始時刻を設定します。この時刻以降のタイムスタンプの監査ログがすべて応答に含まれます。この時刻も含まれます。
--request-filters-end-time
任意です。この検索の終了時刻を設定します。この時刻より前のタイムスタンプの監査ログがすべて応答に含まれます。この時刻は含まれません。
--request-filters-http-response-codes
任意です。HTTP応答コードでフィルタリングします。たとえば、'200'や'503'のように指定します。
--sort-direction
任意です。リスト項目の並べ替え順序を設定します。'ASC'を設定すると、項目はsortField値の昇順で返され、'DESC'を設定すると、項目はsortField値の降順で返されます。[列挙]: ASC,DESC
--sort-field
任意です。並べ替えの基準とするフィールドを設定します。[列挙]:timestamp,operation,resource.id,resource.type,requester.userId,client.id,httpResponseCode
--pagination-context-next-token
任意です。このAPI呼び出しへの応答が切り捨てられると、応答にnextToken要素が含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、このAPIが理解できるOpaque値です。トークンは1時間で有効期限が切れます。
--pagination-context-max-results
任意です。応答本文で返される結果の最大数を設定します。デフォルトの50件より多い結果、または少ない結果を取得する場合、このパラメーターをリクエストに追加できます。最大件数の250を超えるmaxResultsを指定することもできますが、250件を超える項目は返されません。SLA順守の目的で、または該当する項目が少ないために、応答にmaxResultsよりも少ない件数の項目しか含まれない場合はありますが、それよりも多い件数が含まれることは決してありません。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

remove-testers-from-beta-test

特定のスキルのベータテストからテスターを削除します。システムは、各テスターにアクセス終了の通知メールを送信し、参加資格を削除します。

構文

$ ask smapi remove-testers-from-beta-test [--skill-id | -s <スキルID>]
                                          [--testers-emails <テスターのEメール>]
                                          [--profile | -p <プロファイル>]
                                          [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--testers-emails
必須です。ベータテストのテスターのEメールアドレスです。[複数可]: 値はコンマで区切ることができます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

request-feedback-from-testers

特定のAlexaスキルについて、ベータテストに参加しているテスターにフィードバックをリクエストします。システムはテスターに通知メールを送信し、フィードバックをリクエストします。

構文

$ ask smapi request-feedback-from-testers [--skill-id | -s <スキルID>]
                                          [--testers-emails <テスターのEメール>]
                                          [--profile | -p <プロファイル>]
                                          [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--testers-emails
必須です。ベータテストのテスターのEメールアドレスです。[複数可]: 値はコンマで区切ることができます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

reset-entitlement-for-product

現在のユーザーに対して買い切り型の商品(複数可)をリセットします。

構文

$ ask smapi reset-entitlement-for-product [--product-id <商品ID>]
                                          [--stage | -g <ステージ>]
                                          [--profile | -p <プロファイル>]
                                          [--debug]

オプション

--product-id
必須です。スキル内商品のIDです。
--stage、-g
必須です。スキルのステージ。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

search-task

スキルのタスク情報を返します。キーワードとプロバイダースキルIDで検索できます。キーワードとプロバイダースキルIDの両方を省略すると、そのスキルのすべてのタスクが返されます。

構文

$ ask smapi search-task [--skill-id | -s <スキルID>]
                        [--provider-skill-id <プロバイダースキルID>]
                        [--keywords <キーワード>]
                        [--max-results <結果の最大件数>]
                        [--next-token <次のトークン>]
                        [--profile | -p <プロファイル>]
                        [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--provider-skill-id
任意です。プロバイダースキルIDです。
--keywords
任意です。キーワードには、タスクの説明、タスク名、またはタスク定義のタグを含めることができます。キーワードはコンマで区切ります。各キーワードには複数の単語を含めることができます。たとえば、--keywords "computer software, vacuum cleaner"のように指定します。
--max-results
任意です。応答本文で返される結果の最大数を設定します。上限である50件よりも少ない結果を取得する場合、このパラメーターをリクエストに追加できます。上限を超えるmaxResultsを指定することはできません。応答に含まれる項目がmaxResultsより少ない場合はありますが、この値を超えることはありません。検索条件を満たす結果が他にもあるけれど結果が返されない場合、応答にはisTruncated = trueが含まれます。
--next-token
任意です。このAPI呼び出しへの応答が切り捨てられる(isTruncated応答要素の値がtrue)ときは、応答にnextToken要素も含まれます。nextTokenの値は、オブジェクトの次のセットのリストを表示する継続トークンとして次のリクエストで使用できます。継続トークンは、スキル管理APIが理解できるOpaque値です。トークンは24時間で有効期限が切れます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

send-reminder-to-testers

指定したAlexaスキルについて、ベータテストに参加しているテスターにリマインダーを送信します。システムは、各テスターに招待メールを送信し、受諾時にエンタイトルメントを追加します。

構文

$ ask smapi send-reminder-to-testers [--skill-id | -s <スキルID>]
                                     [--testers-emails <テスターのEメール>]
                                     [--profile | -p <プロファイル>]
                                     [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--testers-emails
必須です。ベータテストのテスターのEメールアドレスです。[複数可]: 値はコンマで区切ることができます。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

set-interaction-model

スキルの音声対話モデルを作成します。

構文

$ ask smapi set-interaction-model [--skill-id | -s <スキルID>]
                                  [--stage | -g <ステージ>]
                                  [--locale | -l <ロケール>]
                                  [--interaction-model <対話モデル>]
                                  [--if-match <一致>]
                                  [--profile | -p <プロファイル>]
                                  [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--locale, -l
必須です。リクエストするモデルのロケールです。例:ja-JP、en-US、de-DEなど。
--interaction-model
必須です。音声対話モデルのJSON。[JSON]。
--if-match
任意です。エンティティタグを指定したリクエストヘッダーです。サーバーは、eTagがリソースの現在のeTagと一致した場合にのみリソースを更新します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

set-private-distribution-account-id

非公開の配信アカウントにIDを追加します。

構文

$ ask smapi set-private-distribution-account-id [--skill-id | -s <スキルID>]
                                                [--stage | -g <ステージ>]
                                                [--id <id>]
                                                [--profile | -p <プロファイル>]
                                                [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--id
必須です。スキルを非公開で配信できるARNです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

set-skill-enablement

指定したskillId/stageとcustomerId(Authトークンにより取得)の有効化ステータスを作成/更新します。

構文

$ ask smapi set-skill-enablement [--skill-id | -s <スキルID>]
                                 [--stage | -g <ステージ>]
                                 [--profile | -p <プロファイル>]
                                 [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

set-ssl-certificates

このスキルに関連付けられたSSL証明書を更新します。

構文

$ ask smapi set-ssl-certificates [--skill-id | -s <スキルID>]
                                 [--ssl-certificate-payload <SSL証明書のペイロード>]
                                 [--profile | -p <プロファイル>]
                                 [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--ssl-certificate-payload
必須です。スキルのSSL証明書APIの入力および出力を定義します。[JSON]
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

simulate-skill

Alexaエコシステムでユーザー発話のテキストを渡すスキルの実行をシミュレートする非同期APIです。成功した場合の応答のヘッダーには、シミュレーションリソースの場所が含まれます。このAPIへのリクエストがエラーになった場合、応答にはエラーコードと問題の詳細が含まれます。シミュレートされるスキルは、このAPIのユーザーに属し、このユーザーによって有効にされる必要があります。現時点では、1ユーザーからの同時かつ複数のリクエストは許可されていません。

構文

$ ask smapi simulate-skill [--skill-id | -s <スキルID>]
                           [--stage | -g <ステージ>]
                           [--input-content <入力コンテンツ>]
                           [--device-locale <デバイスのロケール>]
                           [--session-mode <セッションモード>]
                           [--profile | -p <プロファイル>]
                           [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--input-content
必須です。ユーザーがAlexaに対して話しかける発話テキストを表す文字列です。
--device-locale
必須です。シミュレーションで使用する仮想デバイスの有効なロケール("ja-JP"など)です。
--session-mode
任意です。現在のシミュレーションのセッションモードが使用中であることを表します。[列挙]: DEFAULT,FORCE_NEW_SESSION
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

start-beta-test

特定のスキルのベータテストを開始します。システムは、各テスターに招待のEメールを送信し、承諾されると参加資格を追加します。

構文

$ ask smapi start-beta-test [--skill-id | -s <スキルID>]
                            [--profile | -p <プロファイル>]
                            [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

submit-skill-for-certification

スキルの認定を申請します。

構文

$ ask smapi submit-skill-for-certification [--skill-id | -s <スキルID>]
                                           [--publication-method <公開方法>]
                                           [--profile | -p <プロファイル>]
                                           [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--publication-method
任意です。スキルを認定のためだけに申請して後から手動で公開するか、認定直後に公開するかを決定します。公開方法を省略すると、デフォルトで自動公開されます。[列挙]: MANUAL_PUBLISHING,AUTO_PUBLISHING.
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

submit-skill-validation

これは、スキル開発者がスキルに対してさまざまな検証を実行できる非同期APIです。

構文

$ ask smapi submit-skill-validation [--locales | -l <ロケール>]
                                    [--skill-id | -s <スキルID>]
                                    [--stage | -g <ステージ>]
                                    [--profile | -p <プロファイル>]
                                    [--debug]

オプション

--locale, -ls
必須です。
--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。スキルのステージ。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

update-account-linking-info

スキルのアカウントリンク情報を作成します。

構文

$ ask smapi update-account-linking-info [--skill-id | -s <スキルID>]
                                        [--stage | -g <ステージ>]
                                        [--account-linking-request <アカウントリンクリクエスト>]
                                        [--if-match <一致>]
                                        [--profile | -p <プロファイル>]
                                        [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--account-linking-request
必須です。アカウントリンクパートナーの作成に必要なフィールドです。[JSON]
--if-match
任意です。エンティティタグを指定したリクエストヘッダーです。サーバーは、eTagがリソースの現在のeTagと一致した場合にのみリソースを更新します。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

update-beta-test

特定のスキルのベータテストを更新します。

構文

$ ask smapi update-beta-test [--skill-id | -s <スキルID>]
                             [--feedback-email <フィードバックEメール>]
                             [--profile | -p <プロファイル>]
                             [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--feedback-email
任意です。フィードバックを提供するEメールアドレスです。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

update-interaction-model-catalog

カタログを更新します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi update-interaction-model-catalog [--catalog-id | -c <カタログID>]
                                             [--slot-type-description <スロットタイプの説明>]
                                             [--profile | -p <プロファイル>]
                                             [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--slot-type-description
任意です。255文字までのスロットタイプの説明です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

update-interaction-model-catalog-version

指定されたバージョンのカタログの説明と手順を更新します。詳細については、参照ベースのカタログ管理を参照してください。

構文

$ ask smapi update-interaction-model-catalog-version [--catalog-id | -c <カタログID>]
                                                     [--version <バージョン>]
                                                     [--description <説明>]
                                                     [--profile | -p <プロファイル>]
                                                     [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--version
必須です。音声対話モデルのバージョンです。
--description
任意です。カタログの説明です(最大255文字)。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

update-interaction-model-slot-type

スロットタイプの特定バージョンのdescriptionとvendorGuidanceの文字列を更新します。

構文

$ ask smapi update-interaction-model-slot-type [--slot-type-id <スロットタイプID>]
                                               [--slot-type-description <スロットタイプの説明>]
                                               [--profile | -p <プロファイル>]
                                               [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--slot-type-description
任意です。255文字までのスロットタイプの説明です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

update-interaction-model-slot-type-version

スロットタイプの特定バージョンのdescriptionとvendorGuidanceの文字列を更新します。

構文

$ ask smapi update-interaction-model-slot-type-version [--slot-type-id <スロットタイプID>]
                                                       [--version <バージョン>]
                                                       [--slot-type-description <スロットタイプの説明>]
                                                       [--profile | -p <プロファイル>]
                                                       [--debug]

オプション

--slot-type-id
必須です。スロットタイプのIDです。
--version
必須です。音声対話モデルのバージョンです。
--slot-type-description
任意です。255文字までのスロットタイプの説明です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

update-isp-for-product

指定された商品IDのスキル内商品の定義を更新します。開発ステージのみサポートされています。

構文

$ ask smapi update-isp-for-product [--if-match <一致>]
                                   [--product-id <商品ID>]
                                   [--stage | -g <ステージ>]
                                   [--in-skill-product <スキル内商品>]
                                   [--profile | -p <プロファイル>]
                                   [--debug]

オプション

--if-match
任意です。エンティティタグを指定したリクエストヘッダーです。サーバーは、eTagがリソースの現在のeTagと一致した場合にのみリソースを更新します。
--product-id
必須です。スキル内商品のIDです。
--stage、-g
必須です。スキルのステージ。
--in-skill-product
必須です。updateInSkillProduct APIのリクエスト本文を定義します。[JSON]
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

update-skill-manifest

指定したskillIdとステージのスキルマニフェストを更新します。

構文

$ ask smapi update-skill-manifest [--if-match <一致>]
                                  [--skill-id | -s <スキルID>]
                                  [--stage | -g <ステージ>]
                                  [--manifest <マニフェスト>]
                                  [--profile | -p <プロファイル>]
                                  [--debug]

オプション

--if-match
任意です。エンティティタグを指定したリクエストヘッダーです。サーバーは、eTagがリソースの現在のeTagと一致した場合にのみリソースを更新します。
--skill-id, -s
必須です。スキルIDです。
--stage、-g
必須です。新たに認定されたステージを含むスキルのステージです。* `development` - 現在開発中のスキルがこのステージに対応します。 * `certified` - 認定を完了し、公開準備のできたスキルがこのステージに対応します。 * `live` - 現在公開中のスキルがこのステージに対応します。
--manifest
必須です。updateSkill APIのリクエスト本文です。[JSON]
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

upload-catalog

カタログのファイルをアップロードします。

構文

$ ask smapi upload-catalog [--catalog-id | -c <カタログID>]
                           [--file | -f <ファイル>]
                           [--profile | -p <プロファイル>]
                           [--debug]

オプション

--catalog-id, -c
必須です。一意のカタログIDです。
--file, -f
必須です。入力するターゲットファイルのパスです。
--profile, -p
任意です。使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
任意です。このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。

withdraw-skill-from-certification

スキルの認定申請を取り下げます。

構文

$ ask smapi withdraw-skill-from-certification [--skill-id | -s <スキルID>]
                                              [--reason <理由>]
                                              [--message <メッセージ>]
                                              [--profile | -p <プロファイル>]
                                              [--debug]

オプション

--skill-id, -s
必須です。スキルIDです。
--reason
任意です。取り下げる理由です。[列挙]: TEST_SKILL,MORE_FEATURES,DISCOVERED_ISSUE,NOT_RECEIVED_CERTIFICATION_FEEDBACK,NOT_INTEND_TO_PUBLISH,OTHER
--message
必須です。理由がOTHERの場合のみメッセージが必要です。
--profile, -p
使用するASK CLIプロファイルです。このオプションを含めない場合は、ASK CLIはデフォルトのプロファイルを使用します。
--debug
このオプションを指定すると、コマンド出力にデバッグメッセージが表示されます。