使用 cURL

在大多數環境中，您可透過 IBM® Storage Ceph® as a Service 和 cURL 充分發揮命令列操作的效益。

以下是針對 IBM® Storage Ceph® as a Service REST API 的基本 curl 指令「速查表」。

使用 curl 需要對命令列和 Object Storage 有一定程度的熟悉，並從 憑證、端點參照 或 主控台 取得必要的資訊。 如果不熟悉任何術語或變數，可以在名詞解釋中找到它們。

註：個人可識別資訊（PII）：當 命名 建立儲存桶或物件時，請勿使用任何可透過姓名、位置或其他方式識別任何使用者（自然人）的資訊。

要求 IAM 記號

您可以透過兩種方式產生用於驗證請求的 IAM oauth 憑證：一種是使用 curl 指令並搭配 API 金鑰（詳見後文）；另一種則是透過命令列使用 IBM Cloud® CLI。

使用 API 金鑰要求 IAM 記號

請確定您有 API 金鑰。 您可以從 IBM Cloud® Identity and Access Management 中取得 API 金鑰。

curl -X "POST" "https://iam.cloud.ibm.com/oidc/token" \
     -H 'Accept: application/json' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
     --data-urlencode "apikey={api-key}" \
     --data-urlencode "response_type=cloud_iam" \
     --data-urlencode "grant_type=urn:ibm:params:oauth:grant-type:apikey"

取得資源實例 ID

下列部分指令需要 ibm-service-instance-id 參數。 要找出此值，請前往雲端控制台中您的 Object Storage 實例的「憑證」分頁。 如有需要，請建立憑證，然後使用「檢視憑證」選單來查看 JSON 格式。 使用 resource_instance_id 的值。

若要與 curl API 搭配使用，您只需要在最後一個單冒號後面開始，然後在最終雙冒號之前結束的 UUID。 例如，ID「crn:v1:bluemix:public:software-defined-storage:global:a/81caa0254631ce5f9330ae427618f209:39d8d161-22c4-4b77-a856-f11db5130d7d::」可以簡寫為「39d8d161-22c4-4b77-a856-f11db5130d7d」。

後續步驟

IBM Storage Ceph as a Service 的 RESTful API 詳細說明，請參閱 IBM Storage Ceph as a Service Object Storage API 文件。