次の方法で共有

[キー]

  • [アーティクル]

次の構文は、キー リソースを表します。

{
    "name": [string]             // Name of the key
}

Operations

キー リソースを使用すると、次の操作を行うことができます。

  • List

すべての操作において、name は省略可能なフィルター パラメーターです。 省略されている場合は、任意のキーを意味します。

前提条件

  • すべての HTTP 要求が認証される必要があります。 認証に関するセクションを参照してください。
  • すべての HTTP 要求で、明示的な api-version を指定する必要があります。 バージョン管理に関するセクションを参照してください。

キーを一覧表示します。

GET /keys?api-version={api-version} HTTP/1.1

応答:

HTTP/1.1 200 OK
Content-Type: application/vnd.microsoft.appconfig.keyset+json; charset=utf-8"

{
    "items": [
        {
          "name": "{key-name}"
        },
        ...
    ],
    "@nextLink": "{relative uri}"
}

改ページ位置の自動修正

返された項目の数が応答の制限を超えている場合、結果は改ページされます。 省略可能な Link 応答ヘッダーに従い、rel="next" を使用してナビゲーションを行います。 あるいは、コンテンツによって、@nextLink プロパティの形式で次のリンクが指定されます。 次のリンクには api-version パラメーターが含まれています。

GET /keys?api-version={api-version} HTTP/1.1

応答:

HTTP/1.1 OK
Content-Type: application/vnd.microsoft.appconfig.keyset+json; charset=utf-8
Link: <{relative uri}>; rel="next"

{
    "items": [
        ...
    ],
    "@nextLink": "{relative uri}"
}

フィルター処理

name によるフィルター処理がサポートされています。

GET /keys?name={key-name}&api-version={api-version}

次のフィルターがサポートされています。

キー フィルター 結果
name を省略 (または name=*) すべてのキーに一致します
name=abc abc という名前のキーに一致します
name=abc* abc で始まるキー名に一致します
name=abc,xyz キー名 abc または xyz に一致します (CSV の上限は 5 つ)

次の文字は予約されています: *、\、,

予約文字が値の一部である場合は、\{Reserved Character} を使用してエスケープする必要があります。 予約されていない文字もエスケープできます。

フィルター検証

フィルター検証エラーが発生した場合、応答は HTTP 400 で、次のようなエラー詳細が含まれます。

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://azconfig.io/errors/invalid-argument",
  "title": "Invalid request parameter 'name'",
  "name": "name",
  "detail": "name(2): Invalid character",
  "status": 400
}

例

  • All

    GET /keys?api-version={api-version}

  • キー名が abc で始まる

    GET  /keys?name=abc*&api-version={api-version}

  • キー名が abc または xyz のいずれか

    GET /keys?name=abc,xyz&api-version={api-version}

特定のフィールドの要求

省略可能な $select クエリ文字列パラメーターを使用して、要求されたフィールドのコンマ区切りリストを指定します。 $select パラメーターを省略した場合、応答には既定のセットが含まれます。

GET /keys?$select=name&api-version={api-version} HTTP/1.1

時間ベースのアクセス

過去の時間のものとして結果の表現を取得します。 2.1.1 セクションを参照してください。

GET /keys&api-version={api-version} HTTP/1.1
Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT

応答:

HTTP/1.1 200 OK
Content-Type: application/vnd.microsoft.appconfig.keyset+json"
Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT
Link: <relative uri>; rel="original"

{
    "items": [
        ....
    ]
}