すべてのプロダクト
Search
ドキュメントセンター

Serverless App Engine:CreateSecret

最終更新日:Apr 22, 2026

名前空間にシークレットを作成します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

sae:CreateSecret

*All Resource

*

なし なし

リクエスト構文

POST /pop/v1/sam/secret/secret HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

NamespaceId

string

必須

シークレットが存在する名前空間の ID。名前空間がデフォルトの名前空間である場合は、cn-beijing などのリージョン ID のみを入力する必要があります。

cn-beijing:test

SecretName

string

必須

シークレット名。名前に使用できるのは、数字、文字、アンダースコア (_) です。名前は文字で始まる必要があります。

registry-auth-acree

SecretType

string

必須

サポートされているシークレットのタイプ。有効な値:

  • kubernetes.io/dockerconfigjson:イメージリポジトリのユーザー名とパスワードのシークレット。このシークレットは、アプリケーションのデプロイ中にイメージをプルするときの認証に使用されます。

有効な値:

  • Opaque

  • kubernetes.io/dockerconfigjson

  • kubernetes.io/tls

kubernetes.io/dockerconfigjson

SecretData

object

必須

シークレットデータ。

SecretData

string

必須

シークレットのキーと値のペアに関する情報。このパラメーターは必須です。次のフォーマットがサポートされています:

{"Data":"{"k1":"v1", "k2":"v2"}"}

k はキーを指定し、v は値を指定します。

{".dockerconfigjson":"eyJhdXRocyI6eyJyZWdpc3RyeS12cGMuY24tYmVpamluZy5hbGl5dW5jcy5jb20iOnsidXNlcm5hbWUiOiJ1c2VybmFtZSIsInBhc3N3b3JkIjoicGFzc3dvcmQiLCJhdXRoIjoiZFhObGNtNWhiV1U2Y0dGemMzZHZjbVE9In0sInJlZ2lzdHJ5LmNuLWJlaWppbmcuYWxpeXVuY3MuY29tIjp7InVzZXJuYW1lIjoidXNlcm5hbWUiLCJwYXNzd29yZCI6InBhc3N3b3JkIiwiYXV0aCI6ImRYTmxjbTVoYldVNmNHRnpjM2R2Y21RPSJ9fX0="}

例 1: ユーザー名とパスワードを使用して、アカウント間で内部ネットワーク経由で Container Registry からイメージをプルする

  • パブリックドメイン名と内部ドメイン名の両方を入力します。

  • 認証の失敗を防ぐために、usernamepassword、および auth フィールドを設定します。auth のフォーマットは base64Encode($username:$password) です。

次のコードは、フィールド値のデフォルトフォーマットを説明しています:

SecretData[".dockerconfigjson"]=base64Encode(
{
  "auths": {
    "registry-vpc.cn-beijing.aliyuncs.com": {  // $内部ドメイン名
      "username": "username",
      "password": "password",
      "auth": "dXNlcm5hbWU6cGFzc3dvcmQ="
    },
    "registry.cn-beijing.aliyuncs.com": {     // $パブリックドメイン名      "username": "username",                 // $ユーザー名
      "password": "password",                 // $パスワード
      "auth": "dXNlcm5hbWU6cGFzc3dvcmQ="      // base64Encode($username:$password)
    }
  }
} )

レスポンスフィールド

フィールド

説明

object

照会されたポリシー。

RequestId

string

リクエスト ID。

91F93257-7A4A-4BD3-9A7E-2F6EAE6D****

Message

string

操作に対して返されるメッセージです。

success

TraceId

string

トレース ID。この ID を使用して、リクエストの詳細をクエリできます。

0a98a02315955564772843261e****

Data

object

返された結果です。

SecretId

integer

作成されたシークレットの ID。

16

ErrorCode

string

ステータスコード。有効な値:

  • リクエストが成功した場合、ErrorCode は返されません。

  • リクエストが失敗した場合、ErrorCode が返されます。詳細については、このトピックのエラーコードをご参照ください。

Code

string

HTTP ステータスコードまたはエラーコード。有効な値:

  • 2xx:リクエストは成功しました。

  • 3xx:リクエストはリダイレクトされました。

  • 4xx:リクエストは失敗しました。

  • 5xx:サーバーエラーが発生しました。

200

Success

boolean

Secret が作成されたかどうかを示します。有効な値:

  • true:Secret の作成に成功しました。

  • false:Secret の作成に失敗しました。

true

成功レスポンス

JSONJSON

{
  "RequestId": "91F93257-7A4A-4BD3-9A7E-2F6EAE6D****",
  "Message": "success",
  "TraceId": "0a98a02315955564772843261e****",
  "Data": {
    "SecretId": 16
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParameter.NotEmpty You must specify the parameter %s.
400 InvalidParameter.Obviously The specified parameter is invalid {%s}.
400 InvalidParameter.WithMessage The parameter is invalid {%s}: %s
400 SecretNameConflict.AlreadyExist The specified SecretName [%s] already exist in this namespace.
400 QuotaExceeded.SecretInNamespace The specified secret exceeded quota [%s].
400 QuotaExceeded.SecretDataKey The specified key in SecretData exceeded quota [%s].
400 InvalidSecretType.NotAvailable The specified SecretType [%s] is not supported.
400 InvalidSecretDataKey.NotFound The specified Key [%s] does not exist in the specified Secret [%s].
500 OperationFailed.RPCError Internal RPC request processing error.
404 InvalidNamespaceId.NotFound The specified NamespaceId does not exist.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。