Job Executions - Create
エラスティック ジョブの実行を開始します。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/start?api-version=2025-01-01
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
job
|
path | True |
string |
取得するジョブ エージェントの名前。 |
|
job
|
path | True |
string |
取得するジョブの名前。 |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
リソース グループの名前。 名前の大文字と小文字は区別されません。 |
|
server
|
path | True |
string |
サーバーの名前。 |
|
subscription
|
path | True |
string (uuid) |
ターゲット サブスクリプションの ID。 値は UUID である必要があります。 |
|
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
Azureの運用は無事に完了しました。 |
|
| 202 Accepted |
リソース操作が受け入れられます。 ヘッダー
|
|
| Other Status Codes |
予期しないエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 Flow.
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| 名前 | 説明 |
|---|---|
| user_impersonation | ユーザー アカウントを偽装する |
例
Start a job execution.
要求のサンプル
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/start?api-version=2025-01-01
応答のサンプル
{
"name": "5555-6666-7777-8888-999999999999",
"type": "Microsoft.Sql/servers/jobAgents/executions",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5555-6666-7777-8888-999999999999",
"properties": {
"createTime": "2016-09-23T01:00:00Z",
"currentAttempts": 0,
"jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
"jobVersion": 1,
"lastMessage": "Job execution created.",
"lifecycle": "Created",
"provisioningState": "Created"
}
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/locations/westus/jobAgentOperationResults/5555-6666-7777-8888-999999999999?api-version=2017-03-01-preview
定義
| 名前 | 説明 |
|---|---|
|
created |
リソースを作成した ID の種類。 |
|
Error |
リソース管理エラーの追加情報。 |
|
Error |
エラーの詳細。 |
|
Error |
エラー応答 |
|
Job |
ジョブの実行 |
|
Job |
ジョブ実行の詳細な状態。 |
|
Job |
ジョブ実行が実行されるターゲット。 |
|
Job |
ターゲットの型。 |
|
Provisioning |
ジョブ実行の ARM プロビジョニング状態。 |
|
system |
リソースの作成と最後の変更に関連するメタデータ。 |
createdByType
リソースを作成した ID の種類。
| 値 | 説明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
| 名前 | 型 | 説明 |
|---|---|---|
| info |
object |
追加情報。 |
| type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| additionalInfo |
エラーの追加情報。 |
|
| code |
string |
エラー コード。 |
| details |
エラーの詳細。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー オブジェクト。 |
JobExecution
ジョブの実行
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (arm-id) |
リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
リソースの名前 |
| properties.createTime |
string (date-time) |
ジョブの実行が作成された時刻。 |
| properties.currentAttemptStartTime |
string (date-time) |
現在の試行の開始時刻。 |
| properties.currentAttempts |
integer (int32) |
ジョブの実行が試行された回数。 |
| properties.endTime |
string (date-time) |
ジョブの実行が完了した時刻。 |
| properties.jobExecutionId |
string (uuid) |
ジョブ実行の一意識別子。 |
| properties.jobVersion |
integer (int32) |
ジョブのバージョン番号。 |
| properties.lastMessage |
string |
最後の状態またはエラー メッセージ。 |
| properties.lifecycle |
ジョブ実行の詳細な状態。 |
|
| properties.provisioningState |
ジョブ実行の ARM プロビジョニング状態。 |
|
| properties.startTime |
string (date-time) |
ジョブの実行が開始された時刻。 |
| properties.stepId |
integer (int32) |
ジョブ ステップ ID。 |
| properties.stepName |
string |
ジョブ ステップ名。 |
| properties.target |
この実行が実行されるターゲット。 |
|
| systemData |
create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。 |
|
| type |
string |
リソースの型。 例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」 |
JobExecutionLifecycle
ジョブ実行の詳細な状態。
| 値 | 説明 |
|---|---|
| Created |
作成済み |
| InProgress |
進行中 |
| WaitingForChildJobExecutions |
WaitingForChildJobExecutions |
| WaitingForRetry |
リトライを待ちながら |
| Succeeded |
成功しました |
| SucceededWithSkipped |
成功したスキップ |
| Failed |
失敗 |
| TimedOut |
タイムアウト |
| Canceled |
取り消し済み |
| Skipped |
スキップ済み |
JobExecutionTarget
ジョブ実行が実行されるターゲット。
| 名前 | 型 | 説明 |
|---|---|---|
| databaseName |
string |
データベース名。 |
| serverName |
string |
サーバー名。 |
| type |
ターゲットの型。 |
JobTargetType
ターゲットの型。
| 値 | 説明 |
|---|---|
| TargetGroup |
ターゲットグループ |
| SqlDatabase |
SqlDatabase |
| SqlElasticPool |
SqlElasticPool |
| SqlShardMap |
SqlShardMap |
| SqlServer |
SqlServer |
ProvisioningState
ジョブ実行の ARM プロビジョニング状態。
| 値 | 説明 |
|---|---|
| Created |
作成済み |
| InProgress |
進行中 |
| Succeeded |
成功しました |
| Failed |
失敗 |
| Canceled |
取り消し済み |
systemData
リソースの作成と最後の変更に関連するメタデータ。
| 名前 | 型 | 説明 |
|---|---|---|
| createdAt |
string (date-time) |
リソース作成のタイムスタンプ (UTC)。 |
| createdBy |
string |
リソースを作成した ID。 |
| createdByType |
リソースを作成した ID の種類。 |
|
| lastModifiedAt |
string (date-time) |
リソースの最終変更のタイムスタンプ (UTC) |
| lastModifiedBy |
string |
リソースを最後に変更した ID。 |
| lastModifiedByType |
リソースを最後に変更した ID の種類。 |