Public IP Addresses - Ddos Protection Status

Szolgáltatás:

Virtual Networks

API-verzió:

2025-05-01

Nyilvános IP-cím Ddos-védelmi állapotának lekérdezése

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
publicIpAddressName	path	True	string	A nyilvános IP-cím neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Válaszok

Name	Típus	Description
200 OK	PublicIpDdosProtectionStatusResult	Az Azure-művelet sikeresen befejeződött.
202 Accepted		Az erőforrásművelet elfogadott. Fejlécek Location: string Retry-After: integer
Other Status Codes	Common.CloudError	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Get Ddos Protection Status of a Public IP Address

Mintakérelem

HTTP

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

JavaScript

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

Mintaválasz

Állapotkód:

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"
}

Állapotkód:

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

Definíciók

Name	Description
Common.CloudError	Hibaválasz a szolgáltatástól.
Common.CloudErrorBody	Hibaválasz a szolgáltatástól.
IsWorkloadProtected	Az az érték, amely azt jelzi, hogy az IP-cím DDoS-védett-e vagy sem.
PublicIpDdosProtectionStatusResult	Válasz GetPublicIpAddressDdosProtectionStatusOperation API szolgáltatáshívásra.

Common.CloudError

Tárgy

Hibaválasz a szolgáltatástól.

Name	Típus	Description
error	Common.CloudErrorBody	Felhőhiba törzse.

Common.CloudErrorBody

Tárgy

Hibaválasz a szolgáltatástól.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
details	Common.CloudErrorBody[]	A hiba további részleteinek listája.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
target	string	Az adott hiba célja. Például a tulajdonság neve hibás.

IsWorkloadProtected

Felsorolás

Az az érték, amely azt jelzi, hogy az IP-cím DDoS-védett-e vagy sem.

Érték	Description
False	Téves
True	True

PublicIpDdosProtectionStatusResult

Tárgy

Válasz GetPublicIpAddressDdosProtectionStatusOperation API szolgáltatáshívásra.

Name	Típus	Description
ddosProtectionPlanId	string	DDoS Protection-csomag Erőforrás-azonosítója, ha az IP-cím csomagon keresztül védett.
isWorkloadProtected	IsWorkloadProtected	Az az érték, amely azt jelzi, hogy az IP-cím DDoS-védett-e vagy sem.
publicIpAddress	string	A nyilvános IP-erőforrás IP-címe
publicIpAddressId	string	Nyilvános IP ARM-erőforrás-azonosító