Public IP Addresses - Ddos Protection Status

서비스:: Virtual Networks

API 버전:: 2025-05-01

공용 IP 주소의 Ddos 보호 상태를 가져옵니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPAddresses/{publicIpAddressName}/ddosProtectionStatus?api-version=2025-05-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
publicIpAddressName	path	True	string	공용 IP 주소의 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	PublicIpDdosProtectionStatusResult	Azure 작업이 성공적으로 완료되었습니다.
202 Accepted		자원 작업이 허용되었습니다. 헤더 Location: string Retry-After: integer
Other Status Codes	Common.CloudError	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

PublicIpDdosProtectionStatusResult

Azure 작업이 성공적으로 완료되었습니다.

202 Accepted

자원 작업이 허용되었습니다.

헤더

Location: string
Retry-After: integer

Other Status Codes

Common.CloudError

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Get Ddos Protection Status of a Public IP Address

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/test-pip/ddosProtectionStatus?api-version=2025-05-01

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Gets the Ddos Protection Status of a Public IP Address
 *
 * @summary Gets the Ddos Protection Status of a Public IP Address
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/PublicIpAddressGetDdosProtectionStatus.json
 */
async function getDdosProtectionStatusOfAPublicIPAddress() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const publicIpAddressName = "test-pip";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.publicIPAddresses.beginDdosProtectionStatusAndWait(
    resourceGroupName,
    publicIpAddressName,
  );
  console.log(result);
}

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

샘플 응답

상태 코드:: 200

{
  "ddosProtectionPlanId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/ddosProtectionPlans/test-plan",
  "isWorkloadProtected": "True",
  "publicIpAddress": "10.0.1.5",
  "publicIpAddressId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/test-pip"
}

상태 코드:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SampleRG/providers/Microsoft.Network/locations/tempLocation/operationResults/00000000-0000-0000-0000-000000000000?api-version=2025-05-01

정의

Name	Description
Common.CloudError	서비스의 오류 응답입니다.
Common.CloudErrorBody	서비스의 오류 응답입니다.
IsWorkloadProtected	IP 주소가 DDoS 워크로드 보호 여부를 나타내는 값입니다.
PublicIpDdosProtectionStatusResult	GetPublicIpAddressDdosProtectionStatusOperation API 서비스 호출에 대한 응답입니다.

Common.CloudError

Object

서비스의 오류 응답입니다.

Name	형식	Description
error	Common.CloudErrorBody	클라우드 오류 본문.

Common.CloudErrorBody

Object

서비스의 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	Common.CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target	string	특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

IsWorkloadProtected

열거형

IP 주소가 DDoS 워크로드 보호 여부를 나타내는 값입니다.

값	Description
False	거짓
True	진실

PublicIpDdosProtectionStatusResult

Object

GetPublicIpAddressDdosProtectionStatusOperation API 서비스 호출에 대한 응답입니다.

Name	형식	Description
ddosProtectionPlanId	string	DDoS 보호 계획 계획을 통해 IP 주소가 보호되는 경우 리소스 ID입니다.
isWorkloadProtected	IsWorkloadProtected	IP 주소가 DDoS 워크로드 보호 여부를 나타내는 값입니다.
publicIpAddress	string	공용 IP 리소스의 IP 주소
publicIpAddressId	string	공용 IP ARM 리소스 ID