getAssociation method

Future<SecurityPolicyAssociation> getAssociation(
  1. String securityPolicy, {
  2. String? name,
  3. String? $fields,
})

Gets an association with the specified name.

Use this API to read Cloud Armor policies.

Previously, alpha and beta versions of this API were used to read firewall policies. This usage is now disabled for most organizations. Use firewallPolicies.getAssociation instead.

Request parameters:

securityPolicy - Name of the security policy to which the queried rule belongs. Value must have pattern (securityPolicies/)?\[0-9\]{0,20}.

name - The name of the association to get from the security policy.

$fields - Selector specifying which fields to include in a partial response.

Completes with a SecurityPolicyAssociation.

Completes with a commons.ApiRequestError if the API endpoint returned an error.

If the used http.Client completes with an error when making a REST call, this method will complete with the same error.

Implementation

async.Future<SecurityPolicyAssociation> getAssociation(
  core.String securityPolicy, {
  core.String? name,
  core.String? $fields,
}) async {
  final queryParams_ = <core.String, core.List<core.String>>{
    'name': ?name == null ? null : [name],
    'fields': ?$fields == null ? null : [$fields],
  };

  final url_ =
      'locations/global/securityPolicies/' +
      commons.escapeVariable('$securityPolicy') +
      '/getAssociation';

  final response_ = await _requester.request(
    url_,
    'GET',
    queryParams: queryParams_,
  );
  return SecurityPolicyAssociation.fromJson(
    response_ as core.Map<core.String, core.dynamic>,
  );
}