Database Sql Vulnerability Assessment Rule Baselines - Get

サービス:

SQL Database

API バージョン:

2023-08-01

データベースの SQL 脆弱性評価規則のベースラインを取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/sqlVulnerabilityAssessments/default/baselines/default/rules/{ruleId}?api-version=2023-08-01

URI パラメーター

名前	/	必須	型	説明
baselineName	path	True	BaselineName
databaseName	path	True	string	データベースの名前。
resourceGroupName	path	True	string	リソースを含むリソース グループの名前。 この値は、Azure Resource Manager API またはポータルから取得できます。
ruleId	path	True	string	脆弱性評価規則 ID。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
vulnerabilityAssessmentName	path	True	VulnerabilityAssessmentName	脆弱性評価の名前。
api-version	query	True	string	要求に使用する API バージョン。

応答

名前	型	説明
200 OK	DatabaseSqlVulnerabilityAssessmentRuleBaseline	SQL 脆弱性評価規則のベースラインが正常に取得されました。
Other Status Codes	ErrorResponse	エラー応答: *** 400 SqlVulnerabilityAssessmentInvalidUserSuppliedParameter - 無効なパラメーター値がクライアントによって提供されました。 400 InvalidSqlVulnerabilityAssessmentBaselineInput - SQL 脆弱性評価ベースライン入力が null または空です。 400 InvalidSqlVulnerabilityAssessmentSettingsInput - SQL 脆弱性評価設定の入力が null または空です 400 SqlVulnerabilityAssessmentScanResultsAreNotAvailableYet - SQL 脆弱性評価の結果はまだ利用できません。後でもう一度お試しください。 400 SqlVulnerabilityAssessmentInvalidRuleId - SQL 脆弱性評価規則 ID が無効です。 400 SqlVulnerabilityAssessmentScanDoesNotExist - SQL 脆弱性評価スキャンが存在しません。 400 SqlVulnerabilityAssessmentNoBaseline - リソースの最新スキャンのベースラインが見つかりませんでした 400 SqlVulnerabilityAssessmentNoRuleBaseline - SQL 脆弱性評価ベースラインが見つかりませんでした 400 SqlVulnerabilityAssessmentBaselineNoScanResults - ルール ID のスキャン結果が見つかりませんでした。ベースラインを設定するには、利用可能な最新のスキャンでこのルールの結果が必要です 400 SqlVulnerabilityAssessmentBadBinaryRuleFormat - バイナリ ルールの入力がブール値表現ではありません 400 SqlVulnerabilityAssessmentBadRuleFormat - 提供された結果は、スキャン結果の実際のレイアウトに準拠していません 400 SqlVulnerabilityAssessmentBadRuleWithoutRuleIdFormat - 指定された結果がスキャン結果の実際のレイアウトに準拠していません 400 SqlVulnerabilityAssessmentBadBinaryRuleWithoutRuleIdFormat - バイナリ ルールの入力がブール値表現ではありません 400 SqlVulnerabilityAssessmentBaselineNoScanResultsWithoutRuleId - いずれかのルールのスキャン結果が見つかりませんでした。 ベースラインを設定するには、利用可能な最新のスキャンでこのルールの結果が必要です 400 SqlVulnerabilityAssessmentEmptyBaseline - 結果が null または空であるため、ベースラインが設定されていません 400 SqlVulnerabilityAssessmentIsDisabled - SQL 脆弱性評価機能が無効になっています。 他の SQL 脆弱性評価操作を実行する前に、この機能を有効にしてください。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 DatabaseDoesNotExist - ユーザーがこのサーバー インスタンスに存在しないデータベース名を指定しました。 404 SourceDatabaseNotFound - ソース データベースが存在しません。 409 SqlVulnerabilityAssessmentStoragefullApiIsEnabled - このサーバーまたは互換性のないバージョンの基になるデータベースのいずれかで脆弱性評価が有効になっています。 その他のトラブルシューティング情報については、https://aka.ms/SQLVAStoragelessDocumentation参照してください。 409 DatabaseVulnerabilityAssessmentScanIsAlreadyInProgress - SQL 脆弱性評価スキャンは既に進行中です 500 DatabaseIsUnavailable - 読み込みに失敗しました。 後でもう一度やり直してください。

例

Gets a database's sql vulnerability assessment rule baseline.

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/vulnerabilityaseessmenttest-4711/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6411/databases/testdb/sqlVulnerabilityAssessments/default/baselines/default/rules/VA1001?api-version=2023-08-01

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/DatabaseSqlVulnerabilityAssessmentRuleBaselineGet.json
// this example is just showing the usage of "DatabaseSqlVulnerabilityAssessmentRuleBaselines_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResource created on azure
// for more information of creating SqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResource, please refer to the document of SqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "vulnerabilityaseessmenttest-4711";
string serverName = "vulnerabilityaseessmenttest-6411";
string databaseName = "testdb";
VulnerabilityAssessmentName vulnerabilityAssessmentName = VulnerabilityAssessmentName.Default;
SqlVulnerabilityAssessmentBaselineName baselineName = SqlVulnerabilityAssessmentBaselineName.Default;
string ruleId = "VA1001";
ResourceIdentifier sqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResourceId = SqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName, vulnerabilityAssessmentName, baselineName, ruleId);
SqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResource sqlDatabaseSqlVulnerabilityAssessmentBaselineRule = client.GetSqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResource(sqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResourceId);

// invoke the operation
SqlDatabaseSqlVulnerabilityAssessmentBaselineRuleResource result = await sqlDatabaseSqlVulnerabilityAssessmentBaselineRule.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlVulnerabilityAssessmentBaselineRuleData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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/vulnerabilityaseessmenttest-4799/providers/Microsoft.Sql/servers/vulnerabilityaseessmenttest-6440/databases/testdb/sqlVulnerabilityAssessments/default/baselines/default/rules/VA1001",
  "name": "VA1001",
  "type": "Microsoft.Sql/servers/databases/sqlVulnerabilityAssessments/baselineRules",
  "properties": {
    "results": [
      [
        "userA",
        "SELECT"
      ],
      [
        "userB",
        "SELECT"
      ],
      [
        "userC",
        "SELECT"
      ]
    ]
  }
}

定義

名前	説明
BaselineName
createdByType	リソースを作成した ID の種類。
DatabaseSqlVulnerabilityAssessmentRuleBaseline	データベース SQL 脆弱性評価規則のベースライン。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
systemData	リソースの作成と最後の変更に関連するメタデータ。
VulnerabilityAssessmentName	脆弱性評価の名前。

BaselineName

列挙

値	説明
default

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

DatabaseSqlVulnerabilityAssessmentRuleBaseline

Object

データベース SQL 脆弱性評価規則のベースライン。

名前	型	説明
id	string	リソース ID。
name	string	リソース名。
properties.results	string[]	ルールベースラインの結果
systemData	systemData	DatabaseSqlVulnerabilityAssessmentRuleBaselineResource の SystemData。
type	string	リソースの種類。

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラー コード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラー メッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラー オブジェクト。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

VulnerabilityAssessmentName

列挙

脆弱性評価の名前。

値	説明
default