Apigee API . organizations . securityProfiles . environments

close()

Close httplib2 connections.

computeEnvironmentScores(profileEnvironment, body=None, x__xgafv=None)

ComputeEnvironmentScores calculates scores for requested time range for the specified security profile and environment.

Args:
  profileEnvironment: string, Required. Name of organization and environment and profile id for which score needs to be computed. Format: organizations/{org}/securityProfiles/{profile}/environments/{env} (required)
  body: object, The request body.
    The object takes the form of:

{ # Request for ComputeEnvironmentScores.
  "filters": [ # Optional. Filters are used to filter scored components. Return all the components if no filter is mentioned. Example: [{ "scorePath": "/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/source" }, { "scorePath": "/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/target", }] This will return components with path: "/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/source" OR "/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/target"
    { # Filter scores by component path. Used custom filter instead of AIP-160 as the use cases are highly constrained and predictable.
      "scorePath": "A String", # Optional. Return scores for this component. Example: "/org@myorg/envgroup@myenvgroup/env@myenv/proxies/proxy@myproxy/source"
    },
  ],
  "pageSize": 42, # Optional. The maximum number of subcomponents to be returned in a single page. The service may return fewer than this value. If unspecified, at most 100 subcomponents will be returned in a single page.
  "pageToken": "A String", # Optional. A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  "timeRange": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Required. Time range for score calculation. At most 14 days of scores will be returned, and both the start and end dates must be within the last 90 days.
    "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
    "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
  },
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for ComputeEnvironmentScores.
  "nextPageToken": "A String", # A page token, received from a previous `ComputeScore` call. Provide this to retrieve the subsequent page.
  "scores": [ # List of scores. One score per day.
    { # Represents Security Score.
      "component": { # Component is an individual security element that is scored. # Component containing score, recommendations and actions.
        "calculateTime": "A String", # Time when score was calculated.
        "dataCaptureTime": "A String", # Time in the requested time period when data was last captured to compute the score.
        "drilldownPaths": [ # List of paths for next components.
          "A String",
        ],
        "recommendations": [ # List of recommendations to improve API security.
          { # Recommendation based on security concerns and score.
            "actions": [ # Actions for the recommendation to improve the security score.
              { # Action to improve security score.
                "actionContext": { # Action context are all the relevant details for the action. # Action context for the action.
                  "documentationLink": "A String", # Documentation link for the action.
                },
                "description": "A String", # Description of the action.
              },
            ],
            "description": "A String", # Description of the recommendation.
            "impact": 42, # Potential impact of this recommendation on the overall score. This denotes how important this recommendation is to improve the score.
            "title": "A String", # Title represents recommendation title.
          },
        ],
        "score": 42, # Score for the component.
        "scorePath": "A String", # Path of the component. Example: /org@myorg/envgroup@myenvgroup/proxies/proxy@myproxy
      },
      "subcomponents": [ # List of all the drilldown score components.
        { # Component is an individual security element that is scored.
          "calculateTime": "A String", # Time when score was calculated.
          "dataCaptureTime": "A String", # Time in the requested time period when data was last captured to compute the score.
          "drilldownPaths": [ # List of paths for next components.
            "A String",
          ],
          "recommendations": [ # List of recommendations to improve API security.
            { # Recommendation based on security concerns and score.
              "actions": [ # Actions for the recommendation to improve the security score.
                { # Action to improve security score.
                  "actionContext": { # Action context are all the relevant details for the action. # Action context for the action.
                    "documentationLink": "A String", # Documentation link for the action.
                  },
                  "description": "A String", # Description of the action.
                },
              ],
              "description": "A String", # Description of the recommendation.
              "impact": 42, # Potential impact of this recommendation on the overall score. This denotes how important this recommendation is to improve the score.
              "title": "A String", # Title represents recommendation title.
            },
          ],
          "score": 42, # Score for the component.
          "scorePath": "A String", # Path of the component. Example: /org@myorg/envgroup@myenvgroup/proxies/proxy@myproxy
        },
      ],
      "timeRange": { # Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time. # Start and end time for the score.
        "endTime": "A String", # Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
        "startTime": "A String", # Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
      },
    },
  ],
}

computeEnvironmentScores_next()

Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.
        

create(parent, body=None, x__xgafv=None)

CreateSecurityProfileEnvironmentAssociation creates profile environment association i.e. attaches environment to security profile.

Args:
  parent: string, Required. Name of organization and security profile ID. Format: organizations/{org}/securityProfiles/{profile} (required)
  body: object, The request body.
    The object takes the form of:

{ # Represents a SecurityProfileEnvironmentAssociation resource.
  "attachTime": "A String", # Output only. The time when environment was attached to the security profile.
  "name": "A String", # Immutable. Name of the environment that the profile is attached to.
  "securityProfileRevisionId": "A String", # DEPRECATED: DO NOT USE Revision ID of the security profile.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Represents a SecurityProfileEnvironmentAssociation resource.
  "attachTime": "A String", # Output only. The time when environment was attached to the security profile.
  "name": "A String", # Immutable. Name of the environment that the profile is attached to.
  "securityProfileRevisionId": "A String", # DEPRECATED: DO NOT USE Revision ID of the security profile.
}

delete(name, x__xgafv=None)

DeleteSecurityProfileEnvironmentAssociation removes profile environment association i.e. detaches environment from security profile.

Args:
  name: string, Required. The name of the environment attachment to delete. Format: organizations/{org}/securityProfiles/{profile}/environments/{env} (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}