1. Packages
  2. Azure Native v2
  3. API Docs
  4. security
  5. getAssessment
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi

azure-native-v2.security.getAssessment

Explore with Pulumi AI

These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi

Get a security assessment on your scanned resource Azure REST API version: 2021-06-01.

Other available API versions: 2020-01-01.

Using getAssessment

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getAssessment(args: GetAssessmentArgs, opts?: InvokeOptions): Promise<GetAssessmentResult>
function getAssessmentOutput(args: GetAssessmentOutputArgs, opts?: InvokeOptions): Output<GetAssessmentResult>
Copy
def get_assessment(assessment_name: Optional[str] = None,
                   expand: Optional[str] = None,
                   resource_id: Optional[str] = None,
                   opts: Optional[InvokeOptions] = None) -> GetAssessmentResult
def get_assessment_output(assessment_name: Optional[pulumi.Input[str]] = None,
                   expand: Optional[pulumi.Input[str]] = None,
                   resource_id: Optional[pulumi.Input[str]] = None,
                   opts: Optional[InvokeOptions] = None) -> Output[GetAssessmentResult]
Copy
func LookupAssessment(ctx *Context, args *LookupAssessmentArgs, opts ...InvokeOption) (*LookupAssessmentResult, error)
func LookupAssessmentOutput(ctx *Context, args *LookupAssessmentOutputArgs, opts ...InvokeOption) LookupAssessmentResultOutput
Copy

> Note: This function is named LookupAssessment in the Go SDK.

public static class GetAssessment 
{
    public static Task<GetAssessmentResult> InvokeAsync(GetAssessmentArgs args, InvokeOptions? opts = null)
    public static Output<GetAssessmentResult> Invoke(GetAssessmentInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetAssessmentResult> getAssessment(GetAssessmentArgs args, InvokeOptions options)
public static Output<GetAssessmentResult> getAssessment(GetAssessmentArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: azure-native:security:getAssessment
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

AssessmentName
This property is required.
Changes to this property will trigger replacement.
string
The Assessment Key - Unique key for the assessment type
ResourceId
This property is required.
Changes to this property will trigger replacement.
string
The identifier of the resource.
Expand string
OData expand. Optional.
AssessmentName
This property is required.
Changes to this property will trigger replacement.
string
The Assessment Key - Unique key for the assessment type
ResourceId
This property is required.
Changes to this property will trigger replacement.
string
The identifier of the resource.
Expand string
OData expand. Optional.
assessmentName
This property is required.
Changes to this property will trigger replacement.
String
The Assessment Key - Unique key for the assessment type
resourceId
This property is required.
Changes to this property will trigger replacement.
String
The identifier of the resource.
expand String
OData expand. Optional.
assessmentName
This property is required.
Changes to this property will trigger replacement.
string
The Assessment Key - Unique key for the assessment type
resourceId
This property is required.
Changes to this property will trigger replacement.
string
The identifier of the resource.
expand string
OData expand. Optional.
assessment_name
This property is required.
Changes to this property will trigger replacement.
str
The Assessment Key - Unique key for the assessment type
resource_id
This property is required.
Changes to this property will trigger replacement.
str
The identifier of the resource.
expand str
OData expand. Optional.
assessmentName
This property is required.
Changes to this property will trigger replacement.
String
The Assessment Key - Unique key for the assessment type
resourceId
This property is required.
Changes to this property will trigger replacement.
String
The identifier of the resource.
expand String
OData expand. Optional.

getAssessment Result

The following output properties are available:

DisplayName string
User friendly display name of the assessment
Id string
Resource Id
Links Pulumi.AzureNative.Security.Outputs.AssessmentLinksResponse
Links relevant to the assessment
Name string
Resource name
ResourceDetails Pulumi.AzureNative.Security.Outputs.AzureResourceDetailsResponse | Pulumi.AzureNative.Security.Outputs.OnPremiseResourceDetailsResponse | Pulumi.AzureNative.Security.Outputs.OnPremiseSqlResourceDetailsResponse
Details of the resource that was assessed
Status Pulumi.AzureNative.Security.Outputs.AssessmentStatusResponseResponse
The result of the assessment
Type string
Resource type
AdditionalData Dictionary<string, string>
Additional data regarding the assessment
Metadata Pulumi.AzureNative.Security.Outputs.SecurityAssessmentMetadataPropertiesResponse
Describes properties of an assessment metadata.
PartnersData Pulumi.AzureNative.Security.Outputs.SecurityAssessmentPartnerDataResponse
Data regarding 3rd party partner integration
DisplayName string
User friendly display name of the assessment
Id string
Resource Id
Links AssessmentLinksResponse
Links relevant to the assessment
Name string
Resource name
ResourceDetails AzureResourceDetailsResponse | OnPremiseResourceDetailsResponse | OnPremiseSqlResourceDetailsResponse
Details of the resource that was assessed
Status AssessmentStatusResponseResponse
The result of the assessment
Type string
Resource type
AdditionalData map[string]string
Additional data regarding the assessment
Metadata SecurityAssessmentMetadataPropertiesResponse
Describes properties of an assessment metadata.
PartnersData SecurityAssessmentPartnerDataResponse
Data regarding 3rd party partner integration
displayName String
User friendly display name of the assessment
id String
Resource Id
links AssessmentLinksResponse
Links relevant to the assessment
name String
Resource name
resourceDetails AzureResourceDetailsResponse | OnPremiseResourceDetailsResponse | OnPremiseSqlResourceDetailsResponse
Details of the resource that was assessed
status AssessmentStatusResponseResponse
The result of the assessment
type String
Resource type
additionalData Map<String,String>
Additional data regarding the assessment
metadata SecurityAssessmentMetadataPropertiesResponse
Describes properties of an assessment metadata.
partnersData SecurityAssessmentPartnerDataResponse
Data regarding 3rd party partner integration
displayName string
User friendly display name of the assessment
id string
Resource Id
links AssessmentLinksResponse
Links relevant to the assessment
name string
Resource name
resourceDetails AzureResourceDetailsResponse | OnPremiseResourceDetailsResponse | OnPremiseSqlResourceDetailsResponse
Details of the resource that was assessed
status AssessmentStatusResponseResponse
The result of the assessment
type string
Resource type
additionalData {[key: string]: string}
Additional data regarding the assessment
metadata SecurityAssessmentMetadataPropertiesResponse
Describes properties of an assessment metadata.
partnersData SecurityAssessmentPartnerDataResponse
Data regarding 3rd party partner integration
display_name str
User friendly display name of the assessment
id str
Resource Id
links AssessmentLinksResponse
Links relevant to the assessment
name str
Resource name
resource_details AzureResourceDetailsResponse | OnPremiseResourceDetailsResponse | OnPremiseSqlResourceDetailsResponse
Details of the resource that was assessed
status AssessmentStatusResponseResponse
The result of the assessment
type str
Resource type
additional_data Mapping[str, str]
Additional data regarding the assessment
metadata SecurityAssessmentMetadataPropertiesResponse
Describes properties of an assessment metadata.
partners_data SecurityAssessmentPartnerDataResponse
Data regarding 3rd party partner integration
displayName String
User friendly display name of the assessment
id String
Resource Id
links Property Map
Links relevant to the assessment
name String
Resource name
resourceDetails Property Map | Property Map | Property Map
Details of the resource that was assessed
status Property Map
The result of the assessment
type String
Resource type
additionalData Map<String>
Additional data regarding the assessment
metadata Property Map
Describes properties of an assessment metadata.
partnersData Property Map
Data regarding 3rd party partner integration

Supporting Types

AssessmentLinksResponse

AzurePortalUri This property is required. string
Link to assessment in Azure Portal
AzurePortalUri This property is required. string
Link to assessment in Azure Portal
azurePortalUri This property is required. String
Link to assessment in Azure Portal
azurePortalUri This property is required. string
Link to assessment in Azure Portal
azure_portal_uri This property is required. str
Link to assessment in Azure Portal
azurePortalUri This property is required. String
Link to assessment in Azure Portal

AssessmentStatusResponseResponse

Code This property is required. string
Programmatic code for the status of the assessment
FirstEvaluationDate This property is required. string
The time that the assessment was created and first evaluated. Returned as UTC time in ISO 8601 format
StatusChangeDate This property is required. string
The time that the status of the assessment last changed. Returned as UTC time in ISO 8601 format
Cause string
Programmatic code for the cause of the assessment status
Description string
Human readable description of the assessment status
Code This property is required. string
Programmatic code for the status of the assessment
FirstEvaluationDate This property is required. string
The time that the assessment was created and first evaluated. Returned as UTC time in ISO 8601 format
StatusChangeDate This property is required. string
The time that the status of the assessment last changed. Returned as UTC time in ISO 8601 format
Cause string
Programmatic code for the cause of the assessment status
Description string
Human readable description of the assessment status
code This property is required. String
Programmatic code for the status of the assessment
firstEvaluationDate This property is required. String
The time that the assessment was created and first evaluated. Returned as UTC time in ISO 8601 format
statusChangeDate This property is required. String
The time that the status of the assessment last changed. Returned as UTC time in ISO 8601 format
cause String
Programmatic code for the cause of the assessment status
description String
Human readable description of the assessment status
code This property is required. string
Programmatic code for the status of the assessment
firstEvaluationDate This property is required. string
The time that the assessment was created and first evaluated. Returned as UTC time in ISO 8601 format
statusChangeDate This property is required. string
The time that the status of the assessment last changed. Returned as UTC time in ISO 8601 format
cause string
Programmatic code for the cause of the assessment status
description string
Human readable description of the assessment status
code This property is required. str
Programmatic code for the status of the assessment
first_evaluation_date This property is required. str
The time that the assessment was created and first evaluated. Returned as UTC time in ISO 8601 format
status_change_date This property is required. str
The time that the status of the assessment last changed. Returned as UTC time in ISO 8601 format
cause str
Programmatic code for the cause of the assessment status
description str
Human readable description of the assessment status
code This property is required. String
Programmatic code for the status of the assessment
firstEvaluationDate This property is required. String
The time that the assessment was created and first evaluated. Returned as UTC time in ISO 8601 format
statusChangeDate This property is required. String
The time that the status of the assessment last changed. Returned as UTC time in ISO 8601 format
cause String
Programmatic code for the cause of the assessment status
description String
Human readable description of the assessment status

AzureResourceDetailsResponse

Id This property is required. string
Azure resource Id of the assessed resource
Id This property is required. string
Azure resource Id of the assessed resource
id This property is required. String
Azure resource Id of the assessed resource
id This property is required. string
Azure resource Id of the assessed resource
id This property is required. str
Azure resource Id of the assessed resource
id This property is required. String
Azure resource Id of the assessed resource

OnPremiseResourceDetailsResponse

MachineName This property is required. string
The name of the machine
SourceComputerId This property is required. string
The oms agent Id installed on the machine
Vmuuid This property is required. string
The unique Id of the machine
WorkspaceId This property is required. string
Azure resource Id of the workspace the machine is attached to
MachineName This property is required. string
The name of the machine
SourceComputerId This property is required. string
The oms agent Id installed on the machine
Vmuuid This property is required. string
The unique Id of the machine
WorkspaceId This property is required. string
Azure resource Id of the workspace the machine is attached to
machineName This property is required. String
The name of the machine
sourceComputerId This property is required. String
The oms agent Id installed on the machine
vmuuid This property is required. String
The unique Id of the machine
workspaceId This property is required. String
Azure resource Id of the workspace the machine is attached to
machineName This property is required. string
The name of the machine
sourceComputerId This property is required. string
The oms agent Id installed on the machine
vmuuid This property is required. string
The unique Id of the machine
workspaceId This property is required. string
Azure resource Id of the workspace the machine is attached to
machine_name This property is required. str
The name of the machine
source_computer_id This property is required. str
The oms agent Id installed on the machine
vmuuid This property is required. str
The unique Id of the machine
workspace_id This property is required. str
Azure resource Id of the workspace the machine is attached to
machineName This property is required. String
The name of the machine
sourceComputerId This property is required. String
The oms agent Id installed on the machine
vmuuid This property is required. String
The unique Id of the machine
workspaceId This property is required. String
Azure resource Id of the workspace the machine is attached to

OnPremiseSqlResourceDetailsResponse

DatabaseName This property is required. string
The Sql database name installed on the machine
MachineName This property is required. string
The name of the machine
ServerName This property is required. string
The Sql server name installed on the machine
SourceComputerId This property is required. string
The oms agent Id installed on the machine
Vmuuid This property is required. string
The unique Id of the machine
WorkspaceId This property is required. string
Azure resource Id of the workspace the machine is attached to
DatabaseName This property is required. string
The Sql database name installed on the machine
MachineName This property is required. string
The name of the machine
ServerName This property is required. string
The Sql server name installed on the machine
SourceComputerId This property is required. string
The oms agent Id installed on the machine
Vmuuid This property is required. string
The unique Id of the machine
WorkspaceId This property is required. string
Azure resource Id of the workspace the machine is attached to
databaseName This property is required. String
The Sql database name installed on the machine
machineName This property is required. String
The name of the machine
serverName This property is required. String
The Sql server name installed on the machine
sourceComputerId This property is required. String
The oms agent Id installed on the machine
vmuuid This property is required. String
The unique Id of the machine
workspaceId This property is required. String
Azure resource Id of the workspace the machine is attached to
databaseName This property is required. string
The Sql database name installed on the machine
machineName This property is required. string
The name of the machine
serverName This property is required. string
The Sql server name installed on the machine
sourceComputerId This property is required. string
The oms agent Id installed on the machine
vmuuid This property is required. string
The unique Id of the machine
workspaceId This property is required. string
Azure resource Id of the workspace the machine is attached to
database_name This property is required. str
The Sql database name installed on the machine
machine_name This property is required. str
The name of the machine
server_name This property is required. str
The Sql server name installed on the machine
source_computer_id This property is required. str
The oms agent Id installed on the machine
vmuuid This property is required. str
The unique Id of the machine
workspace_id This property is required. str
Azure resource Id of the workspace the machine is attached to
databaseName This property is required. String
The Sql database name installed on the machine
machineName This property is required. String
The name of the machine
serverName This property is required. String
The Sql server name installed on the machine
sourceComputerId This property is required. String
The oms agent Id installed on the machine
vmuuid This property is required. String
The unique Id of the machine
workspaceId This property is required. String
Azure resource Id of the workspace the machine is attached to

SecurityAssessmentMetadataPartnerDataResponse

PartnerName This property is required. string
Name of the company of the partner
Secret This property is required. string
Secret to authenticate the partner and verify it created the assessment - write only
ProductName string
Name of the product of the partner that created the assessment
PartnerName This property is required. string
Name of the company of the partner
Secret This property is required. string
Secret to authenticate the partner and verify it created the assessment - write only
ProductName string
Name of the product of the partner that created the assessment
partnerName This property is required. String
Name of the company of the partner
secret This property is required. String
Secret to authenticate the partner and verify it created the assessment - write only
productName String
Name of the product of the partner that created the assessment
partnerName This property is required. string
Name of the company of the partner
secret This property is required. string
Secret to authenticate the partner and verify it created the assessment - write only
productName string
Name of the product of the partner that created the assessment
partner_name This property is required. str
Name of the company of the partner
secret This property is required. str
Secret to authenticate the partner and verify it created the assessment - write only
product_name str
Name of the product of the partner that created the assessment
partnerName This property is required. String
Name of the company of the partner
secret This property is required. String
Secret to authenticate the partner and verify it created the assessment - write only
productName String
Name of the product of the partner that created the assessment

SecurityAssessmentMetadataPropertiesResponse

AssessmentType This property is required. string
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition
DisplayName This property is required. string
User friendly display name of the assessment
PolicyDefinitionId This property is required. string
Azure resource ID of the policy definition that turns this assessment calculation on
Severity This property is required. string
The severity level of the assessment
Categories List<string>
Description string
Human readable description of the assessment
ImplementationEffort string
The implementation effort required to remediate this assessment
PartnerData Pulumi.AzureNative.Security.Inputs.SecurityAssessmentMetadataPartnerDataResponse
Describes the partner that created the assessment
Preview bool
True if this assessment is in preview release status
RemediationDescription string
Human readable description of what you should do to mitigate this security issue
Threats List<string>
UserImpact string
The user impact of the assessment
AssessmentType This property is required. string
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition
DisplayName This property is required. string
User friendly display name of the assessment
PolicyDefinitionId This property is required. string
Azure resource ID of the policy definition that turns this assessment calculation on
Severity This property is required. string
The severity level of the assessment
Categories []string
Description string
Human readable description of the assessment
ImplementationEffort string
The implementation effort required to remediate this assessment
PartnerData SecurityAssessmentMetadataPartnerDataResponse
Describes the partner that created the assessment
Preview bool
True if this assessment is in preview release status
RemediationDescription string
Human readable description of what you should do to mitigate this security issue
Threats []string
UserImpact string
The user impact of the assessment
assessmentType This property is required. String
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition
displayName This property is required. String
User friendly display name of the assessment
policyDefinitionId This property is required. String
Azure resource ID of the policy definition that turns this assessment calculation on
severity This property is required. String
The severity level of the assessment
categories List<String>
description String
Human readable description of the assessment
implementationEffort String
The implementation effort required to remediate this assessment
partnerData SecurityAssessmentMetadataPartnerDataResponse
Describes the partner that created the assessment
preview Boolean
True if this assessment is in preview release status
remediationDescription String
Human readable description of what you should do to mitigate this security issue
threats List<String>
userImpact String
The user impact of the assessment
assessmentType This property is required. string
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition
displayName This property is required. string
User friendly display name of the assessment
policyDefinitionId This property is required. string
Azure resource ID of the policy definition that turns this assessment calculation on
severity This property is required. string
The severity level of the assessment
categories string[]
description string
Human readable description of the assessment
implementationEffort string
The implementation effort required to remediate this assessment
partnerData SecurityAssessmentMetadataPartnerDataResponse
Describes the partner that created the assessment
preview boolean
True if this assessment is in preview release status
remediationDescription string
Human readable description of what you should do to mitigate this security issue
threats string[]
userImpact string
The user impact of the assessment
assessment_type This property is required. str
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition
display_name This property is required. str
User friendly display name of the assessment
policy_definition_id This property is required. str
Azure resource ID of the policy definition that turns this assessment calculation on
severity This property is required. str
The severity level of the assessment
categories Sequence[str]
description str
Human readable description of the assessment
implementation_effort str
The implementation effort required to remediate this assessment
partner_data SecurityAssessmentMetadataPartnerDataResponse
Describes the partner that created the assessment
preview bool
True if this assessment is in preview release status
remediation_description str
Human readable description of what you should do to mitigate this security issue
threats Sequence[str]
user_impact str
The user impact of the assessment
assessmentType This property is required. String
BuiltIn if the assessment based on built-in Azure Policy definition, Custom if the assessment based on custom Azure Policy definition
displayName This property is required. String
User friendly display name of the assessment
policyDefinitionId This property is required. String
Azure resource ID of the policy definition that turns this assessment calculation on
severity This property is required. String
The severity level of the assessment
categories List<String>
description String
Human readable description of the assessment
implementationEffort String
The implementation effort required to remediate this assessment
partnerData Property Map
Describes the partner that created the assessment
preview Boolean
True if this assessment is in preview release status
remediationDescription String
Human readable description of what you should do to mitigate this security issue
threats List<String>
userImpact String
The user impact of the assessment

SecurityAssessmentPartnerDataResponse

PartnerName This property is required. string
Name of the company of the partner
Secret This property is required. string
secret to authenticate the partner - write only
PartnerName This property is required. string
Name of the company of the partner
Secret This property is required. string
secret to authenticate the partner - write only
partnerName This property is required. String
Name of the company of the partner
secret This property is required. String
secret to authenticate the partner - write only
partnerName This property is required. string
Name of the company of the partner
secret This property is required. string
secret to authenticate the partner - write only
partner_name This property is required. str
Name of the company of the partner
secret This property is required. str
secret to authenticate the partner - write only
partnerName This property is required. String
Name of the company of the partner
secret This property is required. String
secret to authenticate the partner - write only

Package Details

Repository
azure-native-v2 pulumi/pulumi-azure-native
License
Apache-2.0
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi