Job Credentials - Create Or Update

サービス:

SQL Database

API バージョン:

2021-11-01

ジョブ資格情報を作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/credentials/{credentialName}?api-version=2021-11-01

URI パラメーター

名前	/	必須	型	説明
credentialName	path	True	string	資格情報の名前。
jobAgentName	path	True	string	ジョブ エージェントの名前。
resourceGroupName	path	True	string	リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	必須	型	説明
properties.password	True	string	資格情報パスワード。
properties.username	True	string	資格情報ユーザー名。

応答

名前	型	説明
200 OK	JobCredential	資格情報が正常に更新されました。
201 Created	JobCredential	資格情報が正常に作成されました。
Other Status Codes		エラー応答: *** 400 InvalidResourceRequestBody - 要求本文のリソースまたはリソースのプロパティが空または無効です。 400 InvalidJobCredentialUsername - 資格情報のユーザー名が無効です。 403 JobCredentialPermissionError - Azure Resource Managerには、資格情報を使用または管理するためのアクセス許可がありません。 404 JobAgentNotFound - 指定されたジョブ エージェントが、指定された論理サーバーに存在しません。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。

例

Create or update a credential

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/cred1?api-version=2021-11-01

{
  "properties": {
    "username": "myuser",
    "password": "<password>"
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.JobCredentialInner;

/**
 * Samples for JobCredentials CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobCredential.json
     */
    /**
     * Sample code: Create or update a credential.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateACredential(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobCredentials().createOrUpdateWithResponse("group1", "server1",
            "agent1", "cred1", new JobCredentialInner().withUsername("myuser").withPassword("fakeTokenPlaceholder"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/cred1",
  "name": "cred1",
  "type": "Microsoft.Sql/servers/jobAccounts/credentials",
  "properties": {
    "username": "myuser"
  }
}

状態コード:

201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/cred1",
  "name": "cred1",
  "type": "Microsoft.Sql/servers/jobAccounts/credentials",
  "properties": {
    "username": "myuser"
  }
}

定義

JobCredential

ジョブがターゲット データベースに接続するために使用できる格納された資格情報。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.password	string	資格情報パスワード。
properties.username	string	資格情報ユーザー名。
type	string	リソースの種類。