Oracle Cloud Infrastructure Compute ClassicのREST API

コンテナ内のすべてのACLに関する詳細の取得

get

/network/v1/acl/{container}/

指定したコンテナ内の、使用可能なすべてのACLの詳細を取得します。

必要なロール: このタスクを実行するには、Compute_Operationsのロールが必要です。このロールが割り当てられていない、または割当てが不明な場合は、システム管理者に連絡してロールがユーザーにOracle Cloud My Servicesで割り当てられるようにしてください。 Oracle Cloudの管理および監視のユーザー・ロールの変更に関する項を参照してください。

リクエスト

サポートされるメディア・タイプ

application/oracle-compute-v3+json

パス・パラメータ

container: string

/Compute-identity_domain/userまたは
/Compute-identity_domain

ヘッダー・パラメータ

Cookie: string

Cookie:ヘッダーは、サービスに対するすべてのリクエストに含まれる必要があります。それをPOST /authenticate/コールに対して受信されたレスポンス内のset-cookieヘッダーの値に設定してください。

トップに戻る

レスポンス

サポートされるメディア・タイプ

application/oracle-compute-v3+json

200レスポンス

OK。返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

ヘッダー

set-cookie: string

セッションが拡張された場合、Cookie値が返されます。

ルート・スキーマ : Acl-list-response

型: object

ソースの表示

result(optional): array result

{
    "properties":{
        "result":{
            "items":{
                "$ref":"#/definitions/Acl-response"
            },
            "type":"array"
        }
    }
}

ネストされたスキーマ : result

型: array

ソースの表示

Array of: object Acl-response

{
    "items":{
        "$ref":"#/definitions/Acl-response"
    },
    "type":"array"
}

ネストされたスキーマ : Acl-response

型: object

ソースの表示

description(optional): string

オブジェクトの説明。
enabledFlag(optional): boolean

trueはACLが有効であることを示し、falseはACLが無効であることを示します。
name(optional): string

オブジェクトの3つの部分からなる名前(/Compute-identity_domain/user/object)。
tags(optional): array tags

オブジェクトに関連付けられているタグ。
uri(optional): string

Uniform Resource Identifier

{
    "properties":{
        "description":{
            "type":"string",
            "description":"Description of the object."
        },
        "enabledFlag":{
            "type":"boolean",
            "description":"True indicates that ACL is enabled; false indicates that the ACL is disabled."
        },
        "name":{
            "type":"string",
            "description":"The three-part name of the object (/Compute-identity_domain/user/object)."
        },
        "tags":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"Tags associated with the object."
        },
        "uri":{
            "type":"string",
            "description":"Uniform Resource Identifier"
        }
    }
}

ネストされたスキーマ : tags

型: array

オブジェクトに関連付けられているタグ。

ソースの表示

Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"Tags associated with the object."
}

トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、Compute-acmeコンテナ内のすべてのアクセス制御リストの詳細を取得する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

コマンドを1行で入力します。この例では、読みやすくするために改行が使用されています。

curl -X GET 
     -H "Cookie: $COMPUTE_COOKIE"
     -H "Content-Type: application/oracle-compute-v3+json"
     -H "Accept: application/oracle-compute-v3+json"
     https://api-z999.compute.us0.oraclecloud.com/network/v1/acl/Compute-acme

COMPUTE_COOKIEは、前の手順で認証cookieを格納した変数の名前です。認証クッキーの取得および変数への格納の詳細は、認証を参照してください。
api-z999.compute.us0.oraclecloud.comはRESTエンドポイントURLの例です。この値をCompute ClassicサイトのRESTエンドポイントURLに変更します。サイトのRESTエンドポイントURLを見つける方法については、「リクエストの送信」を参照してください。
acmeおよびjack.jones@example.comは値の例です。 acmeをCompute Classicアカウントのアイデンティティ・ドメインIDに置き換え、jack.jones@example.comをユーザー名で置き換えます。

レスポンス本文の例

次の例は、レスポンス本文をJSON形式で示しています。

{
  "result": [
    {
      "name": "/Compute-acme/jack.jones@example.com/acl1",
      "uri": "https://api-z999.compute.us0.oraclecloud.com:443/network/v1/acl/Compute-acme/jack.jones@example.com/acl1",
      "description": "Updating sample ACL 1",
      "tags": [
        "test"
      ],
      "enabledFlag": false
    },
    {
      "name": "/Compute-acme/default",
      "uri": "https://api-z999.compute.us0.oraclecloud.com:443/network/v1/acl/Compute-acme/default",
      "description": null,
      "tags": [
        
      ],
      "enabledFlag": true
    }
  ]
}

トップに戻る